Message Queuing Error and Information Codes
Error and information codes are returned in two ways: directly by Message Queuing functions and COM object methods, or via the optional aStatus array specified in an MQQUEUEPROPS, MQMSGPROPS, MQQMPROPS, or MQPRIVATEPROPS, structure.
The following error and information codes are defined in mq.h.
Returned when a nonspecific Message Queuing error occurs.
Returned when access to the specified queue or computer is denied.
When returned, verify that your are allowed the access rights for performing the operation on the applicable object (for example, creating, setting properties, or deleting a queue). To change the access rights of a queue, call MQSetQueueSecurity.
Returned when the security context specified by PROPID_M_SECURITY_CONTEXT is invalid.
Returned when the additional application-generated header elements (PROPID_M_SOAP_HEADER) for inclusion in the SOAP envelope of an SRMP message do not form a valid XML document.
When reading messages, the buffer supplied for a property is too small. In the case of the message body buffer, the portion of the message body that fits is copied to the buffer, but the message is not removed from the queue.
Returned when Message Queuing cannot create a certificate store for its internal certificate. This error is returned only when you do not have permission to manipulate your own profile.
Returned when Message Queuing cannot compute the hash value for validating an MSMQ 2.0 signature in an authenticated message.
Returned when an attempt is made to create an object that should be owned by a primary site controller and the operation cannot be performed.
Returned when an attempt is made to delete an object that is owned by a primary site controller and the operation cannot be performed.
Returned when the dynamic-link library Mqad.dll cannot be loaded.
Returned when the hash calculated from the message properties cannot be encrypted with the sender's private key to create an MSMQ 2.0 signature, for example, when an MSMQ 2.0 signature is requested for an authenticated message sent to a multiple-element format name or a distribution list.
Returned when the RPC server cannot impersonate the client application. The security credentials could not be verified.
Message Queuing cannot open the certificate store for its internal certificate. This error is returned only when you do not have permission to manipulate your own profile.
Returned when the security descriptor of the cryptographic key container cannot be modified.
Returned when an attempt is made to update an object that is owned by a primary site controller and the operation cannot be performed.
Returned when the sites where the computer resides cannot be resolved. The subnets in the network may not be configured correctly in Active Directory Domain Services (AD DS) or one or more sites may not be configured with the appropriate subnet.
Returned when the sending application attempts to send a message with a request for authentication without a certificate or with a security context that does not include a certificate.
Returned when encryption is requested and the computer (source or destination) does not support encryption operations.
When this error is returned the encryption operation fails.
(MSMQ 1.0 only.) Returned when the Message Queuing-supplied internal certificate is corrupted.
Returned when the Microsoft® Internet Explorer personal certificate store is corrupted.
Returned when the file for the queue specified in the Lqs folder has been deleted because it was corrupted.
Returned when a cryptographic (CryptoAPI) function has failed.
Returned when Message Queuing cannot retrieve the account information for the user.
Returned when Message Queuing cannot retrieve the SID from the thread access token or from the security context specified in the message.
(MSMQ 1.0 only.) Returned when the specified connected network (CN) cannot be deleted because it is defined in at least one other computer. Remove the CN from all CN lists and try again.
Returned when the number of dependent clients served by a Message Queuing server reaches its upper limit.
Returned when binding to the forest root fails.
This error usually indicates a problem in the DNS configuration.
Returned when an internal error in the directory service is issued.
(MSMQ 1.0 only.) Returned when the MSMQ Information Store (MQIS) is full.
(Introduced in MSMQ 3.0.) Returned when a local user, who is authenticated as an anonymous user, attempts to access AD DS.
Only authenticated domain users can access AD DS.
Returned when Message Queuing cannot connect to the Microsoft® Distributed Transaction Coordinator (MS DTC).
Returned when the cryptographic service provider specified is not supported by Message Queuing.
Returned when Message Queuing cannot verify the MSMQ 2.0 signature in the message.
Returned when the specified format name buffer is too small to contain the format name of the queue.
Returned when an attempt is made to create an MSMQ Configuration (msmq) object with a predetermined GUID. By default, a Windows forest does not allow adding an AD DS object with a predetermined GUID.
Returned when the lpwcsContext parameter of MQLocateBegin is not NULL.
Returned when the dwAction parameter of MQReceiveMessage is set to MQ_ACTION_PEEK_NEXT and the cursor is currently at the end of the queue.
Returned when an application attempts to create an MsmqServices object.
Returned when the specified format name is not valid.
Returned when pColumns is set to NULL.
Returned when no properties are specified in the MQQUEUEPROPS structure, or the pQueueProps parameter is set to NULL.
Returned when the requested operation is not supported on the foreign messaging system.
Returned when the specified buffer for the message identifier or correlation identifier does not have the correct size.
Returned when an illegal property value is specified in the MQPROPVARIANT array.
Returned when an illegal type indicator is specified in the vt field of the MQPROPVARIANT array.
Returned when an invalid property identifier is specified in the property identifier array.
Returned when an invalid Message Queuing path name is specified for the queue.
Returned when an invalid relationship parameter is specified.
Returned when an invalid property identifier is specified in MQRESTRICTION.
Returned when an invalid security descriptor is specified.
Returned when an illegal sort operation is specified in MQSORTSET.
Returned when an invalid property identifier is specified in MQSORTSET.
Returned when an invalid user is specified.
Returned when not all properties required for the operation were specified.
Returned when there are insufficient resources (for example, not enough memory) to complete the operation.
When this error is returned the operation fails.
Returned when the internal or external certificate specified is already registered in the directory service for the user.
Returned when the user certificate specified by PROPID_M_SENDER_CERT is invalid, or the certificate is not correctly placed in the Microsoft® Internet Explorer personal certificate store.
Returned when the specified queue handle is invalid.
Returned when an invalid object owner is specified. For example, this code is returned when trying to create a queue on a computer where Message Queuing is not installed.
Returned when one of the IN parameters supplied by the operation is not valid.
Returned when the MQReceiveMessage I/O time-out has expired.
Returned when the specified message label is too long. The message label should be equal to or less than MQ_MAX_MSG_LABEL_LEN (250 Unicode characters).
Returned when the message label buffer supplied is too small for the label of the message received.
Returned when an MSMQ configuration (msmq) object already exists in AD DS for the specified computer name.
Returned when the computer specified could not be found in the directory service.
Returned when some other cursor, application, or system administrator (using the directory service) has already removed the message from the queue.
Returned when the message does not exist or was removed from the queue.
Returned when a recoverable or journal message cannot be stored on the local computer.
Returned when the connector type property (PROPID_M_CONNECTOR_TYPE) is not specified and either a property typically generated by Message Queuing is specified by the application or the message is an application-encrypted message.
Returned when the list of MSMQ Information Store (MQIS) servers (in the registry) is empty.
Returned when multiple sort keys are specified in MQSORTSET in an AD DS environment.
Returned when the application cannot access the directory service.
When this error is returned, verify permissions for accessing the directory service.
Returned when no internal certificate is registered or the registered certificate is corrupted.
Returned during migration when there is no MSMQ Users organizational unit object in AD DS for the domain. The container for the upgraded user object must be created manually.
Returned when there is no response from the object owner.
When this error is returned the status of the operation is unknown.
Returned when the object whose properties are being retrieved from AD DS does not belong to the class requested.
Returned when the requested operation is not supported for dependent clients.
Returned when the object owner is not available.
When this error is returned the operation fails.
Returned when an operation is canceled before it could be completed. For example, during a message receiving operation, the queue handle is closed by another thread before a new message arrives.
Returned when an attempt is made to receive or peek at a message using a lookup identifier from a remote queue residing on a computer running MSMQ 1.0 or MSMQ 2.0.
Returned when the application does not have the required privileges to perform the operation.
Returned when one or more of the property identifiers specified is invalid.
Returned when a specified property is not valid for the operation requested (for example, specifying PROPID_Q_INSTANCE when setting queue properties).
Returned when the provider name buffer is too small for the cryptographic service provider name returned.
(Introduced in MSMQ 2.0.) Returned when you attempt to retrieve any encryption key property and the key is not registered in the directory service. Message Queuing was able to successfully query the directory service, but the enhanced key was not found.
(Introduced in MSMQ 2.0.) Returned when you attempt to retrieve PROPID_QM_ENCRYPTION_PK_ENHANCED and Message Queuing is operating in a mode that supports only 40-bit encryption. For example, you are trying to retrieve the computer properties of a computer running MSMQ 1.0.
Returned when the queue is deleted before the message could be read.
The specified queue handle is no longer valid, and the queue must be closed.
Returned when a queue with the identical Message Queuing path name is already registered.
Public queues are registered in the directory service. Private queues are registered in the local computer.
Returned when the queue is not open or does not exist, for example, in an attempt to restart the transmission of messages from an outgoing queue.
Returned when an error occurs while trying to read a message from a queue residing on a remote computer.
Returned when Message Queuing cannot find the queue. Such queues include public queues not registered in the directory service and Internet queues that do not exist in the MSMQ namespace. This error is also returned when the user does not have sufficient permissions to perform the operation.
Returned when opening a queue for reading messages on a remote computer that is not available or when creating a cursor for a queue on a remote computer that is not available.
Returned when the buffer supplied for the result is too small.
MQLocateNext could not return at least one complete query result.
Returned when the buffer passed to MQGetQueueSecurity is too small for the security descriptor.
Returned when the sender certificate buffer supplied is too small for the certificate retrieved.
Returned when the sender identifier buffer supplied is too small.
Returned when the application is unable to connect to the queue manager.
Returned when the digital signature buffer is too small for the digital signature retrieved.
Returned when the application is trying to open an already opened queue for exclusive reading, or the application is trying to open a queue that is already opened and does not allow sharing.
Returned when the specified handle was obtained in a previous session of the Message Queuing service.
Returned when the symmetric key buffer is too small for the symmetric key retrieved.
Returned when Message Queuing cannot enlist in the specified transaction.
Returned when Message Queuing cannot import the specified transaction.
Returned when the transaction operation sequence is incorrect.
While reading messages, one of the following actions was attempted within the context of a transaction:
An attempt was made to open a remote queue for read access.
An attempt was made to read a message from a nontransactional queue.
An attempt was made to read a message using a callback or overlap function.
For sending messages in MSMQ 1.0 and MSMQ 2.0, either the message is sent as part of a transaction and the destination queue is a nontransactional queue, or the message is not sent as part of a transaction and the destination queue is a transactional queue. In MSMQ 3.0, the loss of transactional messages sent to nontransactional queues or of nontransactional messages sent to transactional queues is reported in negative acknowledgment messages.
Returned when a write operation is attempted to the MSMQ Information Store (MQIS) and write operations are not allowed because a new MQIS server is being installed.
Returned when an attempt is made to use an MSMQManagement object before it is initialized.
Returned when the access mode specified when opening the queue is set to an invalid value, or the access mode and the share mode specified are not compatible.
Returned when information is requested for an AD DS object that is not an instance of a supported class.
Returned when the requested operation is not supported for the specified format name (for example, trying to delete a queue using a direct format name).
Returned when a computer operating in workgroup mode attempts to perform an operation that is not supported in workgroup mode.
Returned when the buffer supplied is too small to hold the user information returned.
Returned when an RPC request is sent to an independent client to perform an operation for a dependent client. A Message Queuing server is required.
Returned when a property specified has already been specified in the property identifier array.
When duplicate settings are found, the first entry is used, and subsequent settings are ignored.
Returned when the format name buffer supplied to MQCreateQueue is too small. The queue is still created.
Returned when an invalid property identifier is specified in aPropID.
Returned when an internal certificate already exists for the user.
Returned when an asynchronous operation is pending.
Returned when the queue owner is not set in the SECURITY_INFORMATION structure during the processing of a call to MQSetQueueSecurity.
Returned when one or more of the properties passed resulted in a warning, but the operation completed.
Returned when a specified property is not valid for the operation being performed (for example, PROPID_M_SENDERID is not valid when it is specified in the message properties structure passed to MQSendMessage; this property is set by Message Queuing when sending messages).
Returned when a specified property is not supported by the operation being performed. The property is ignored.