MessageQueueErrorCode Enumeration

.NET Framework (current version)
 

This API supports the product infrastructure and is not intended to be used directly from your code.

Identifies the source of an error that occurred within the Message Queuing application and generated a MessageQueueException exception.

Namespace:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

C#
C++
F#
VB
Copy 
public enum class MessageQueueErrorCode

Member nameDescription
AccessDenied

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Access is denied.

BadSecurityContext

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Bad security context.

Base

This API supports the product infrastructure and is not intended to be used directly from your code. Message Queuing does not return this error code.

BufferOverflow

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The buffer supplied to MQReceiveMessage for message body retrieval was too small. The message is not removed from the queue and part of the message body that fits in the buffer was copied.

CannotCreateCertificateStore

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to create a certificate store for the internal certificate.

CannotCreateHashEx

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to create a hash object for an authenticated message.

CannotCreateOnGlobalCatalog

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to create an object on a specified global catalog server.

CannotGetDistinguishedName

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to retrieve the distinguished name of local computer.

CannotGrantAddGuid

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to grant the "Add Guid" permission to current user.

CannotHashDataEx

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to hash data for an authenticated message.

CannotImpersonateClient

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The RPC server cannot impersonate the client application, hence security credentials could not be verified.

CannotJoinDomain

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to join Message Queuing enterprise on Windows 2000 domain.

CannotLoadMsmqOcm

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Cannot load the MSMQOCM.DLL library.

CannotOpenCertificateStore

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to open the certificates store for the internal certificate.

CannotSetCryptographicSecurityDescriptor

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to set the security descriptor for the cryptographic keys.

CannotSignDataEx

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to sign data before sending an authenticated message.

CertificateNotProvided

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: A user attempted to send an authenticated message without a certificate.

ComputerDoesNotSupportEncryption

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The computer does not support encryption operations.

CorruptedInternalCertificate

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The internal Message Queuing certificate is corrupted.

CorruptedPersonalCertStore

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The personal certificate store is corrupted.

CorruptedQueueWasDeleted

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The.ini file for the queue in LQS was deleted because it was corrupted.

CorruptedSecurityData

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: A cryptographic function has failed.

CouldNotGetAccountInfo

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Could not get the account information for the user.

CouldNotGetUserSid

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Could not get the SID information out of the thread token.

DeleteConnectedNetworkInUse

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The connected network cannot be deleted; it is in use.

DependentClientLicenseOverflow

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The number of dependent clients served by this Message Queuing server reached its upper limit.

DsError

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Internal directory service error.

DsIsFull

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Directory service is full.

DtcConnect

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Cannot connect to MS DTC.

EncryptionProviderNotSupported

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The Cryptographic Service Provider is not supported by Message Queuing.

FailVerifySignatureEx

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Signature of received message is not valid.

FormatNameBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The format name buffer supplied to the API was too small to fit the format name.

Generic

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Generic Error.

GuidNotMatching

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to create Message Queuing configuration object with a GUID that matches the computer installation. You must uninstall Message Queuing and then reinstall it.

IllegalContext

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid context parameter.

IllegalCriteriaColumns

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid MQCOLUMNS parameter.

IllegalCursorAction

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: MQ_ACTION_PEEK_NEXT specified to MQReceiveMessage can not be used with the current cursor position.

IllegalEnterpriseOperation

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The operation is invalid for a Message Queuing services object.

IllegalFormatName

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The given format name is invalid.

IllegalMessageProperties

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Illegal MQQMPROPS parameter, either null or with zero properties.

IllegalOperation

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The operation is invalid on foreign message queuing systems.

IllegalPrivateProperties

This API supports the product infrastructure and is not intended to be used directly from your code. The private properties parameter value is invalid. This may be because it has a null value or has zero properties specified.

IllegalPropertyId

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid property identifier value.

IllegalPropertySize

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Illegal property buffer size.

IllegalPropertyValue

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid property value.

IllegalPropertyVt

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid VARTYPE value.

IllegalQueuePathName

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid queue path name.

IllegalQueueProperties

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Illegal MQQUEUEPROPS parameter, either null or with zero properties.

IllegalRelation

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid relation value in restriction.

IllegalRestrictionPropertyId

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid propid value in MQRESTRICTION parameter.

IllegalSecurityDescriptor

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The specified security descriptor is not a valid security descriptor.

IllegalSort

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Illegal sort specified (for example, duplicate columns).

IllegalSortPropertyId

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid propid value in MQSORTSET.

IllegalUser

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The user has an invalid user name.

InsufficientProperties

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Not all the required properties for the operation were specified in the input parameters.

InsufficientResources

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Insufficient resources to perform operation.

InvalidCertificate

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The user certificate is not valid.

InvalidHandle

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: An invalid handle passed to a function.

InvalidOwner

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid object owner. For example CreateQueue failed because the Queue Manager object is invalid.

InvalidParameter

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: An invalid parameter passed to a function.

IOTimeout

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The receive or peek message time-out has expired.

LabelBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The label buffer supplied to the API was too small.

MachineExists

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Computer with the same name already exists in the site.

MachineNotFound

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The specified computer could not be found.

MessageAlreadyReceived

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: A message that is currently pointed at by the cursor has been removed from the queue by another process or by another call to receive the message without the use of this cursor.

MessageNotFound

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The specified message could not be found.

MessageStorageFailed

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Could not store a recoverable or journal message. Message was not sent.

MissingConnectorType

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Connector Type is mandatory when sending an Acknowledgment or secure message.

MqisReadOnlyMode

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: MQIS database is in read-only mode.

MqisServerEmpty

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The list of MQIS servers (in registry) is empty.

NoDs

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: No connection with this site's controller(s).

NoEntryPointMsmqOcm

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Cannot locate an entry point in the MSMQOCM.DLL library.

NoGlobalCatalogInDomain

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to find Global Catalog servers in the specified domain.

NoInternalUserCertificate

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The internal Message Queuing certificate for the user does not exist.

NoMsmqServersOnDc

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to find Message Queuing servers on domain controllers.

NoMsmqServersOnGlobalCatalog

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Failed to find Message Queuing servers on Global Catalog domain controllers.

NoResponseFromObjectServer

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: No response from object owner.

ObjectServerNotAvailable

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Object owner is not reachable.

OperationCanceled

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The operation was canceled before it could be completed.

PrivilegeNotHeld

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Client does not have the required privileges to perform the operation.

Property

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: One or more of the passed properties are invalid.

PropertyNotAllowed

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Invalid property for the requested operation

ProviderNameBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The passed buffer for the Provider name property is too small.

PublicKeyDoesNotExist

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The public key for the computer does not exist.

PublicKeyNotFound

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Unable to find the public key for computer.

QDnsPropertyNotSupported

This API supports the product infrastructure and is not intended to be used directly from your code. DNS property is not supported as criteria to locate queues.

QueueDeleted

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The queue was deleted. Messages cannot be received anymore using this queue instance. The queue should be closed.

QueueExists

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: A queue with the same pathname is already registered.

QueueNotAvailable

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Error while reading from a queue residing on a remote computer.

QueueNotFound

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The queue is not registered in the directory service.

RemoteMachineNotAvailable

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The remote machine is not available.

ResultBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The supplied result buffer is too small.

SecurityDescriptorBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The size of the buffer passed to MQGetQueueSecurity is too small.

SenderCertificateBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The passed buffer for the user certificate property is too small.

SenderIdBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The passed buffer for the user identifier property is too small.

ServiceNotAvailable

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The Message Queues service is not available.

SharingViolation

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Sharing violation. The queue is already opened for exclusive receive.

SignatureBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The passed buffer for the Signature property is too small.

StaleHandle

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The Queue Manager service has been restarted. The queue handle is stale and should be closed.

SymmetricKeyBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The passed buffer for the Symmetric key property is too small.

TransactionEnlist

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Cannot enlist the transaction.

TransactionImport

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Cannot import the transaction.

TransactionSequence

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Wrong transaction operations sequence.

TransactionUsage

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Wrong transaction usage.

UnsupportedAccessMode

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The specified access mode is not supported.

UnsupportedFormatNameOperation

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The requested operation for the specified format name is not supported.

UnsupportedOperation

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: The operation is not supported for a WORKGROUP installation computer.

UserBufferTooSmall

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Request failed because user buffer is too small to hold the returned information.

WksCantServeClient

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Message Queuing-independent clients cannot serve Message Queuing-dependent clients.

WriteNotAllowed

This API supports the product infrastructure and is not intended to be used directly from your code. Message text: Another MQIS server is being installed; write operations to the database are not allowed at this time.

The MessageQueueErrorCode enumeration gives detailed information about an error condition during a messaging operation.

The MessageQueueException uses the MessageQueueErrorCode property to identify the nature of the Message Queuing error. The MessageQueueErrorCode value determines a text string to associate with the error.

The following code example verifies whether a Message Queuing queue exists, and then deletes it.

C#
C++
VB
Copy 
#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;
int main()
{

   // Determine whether the queue exists.
   if ( MessageQueue::Exists( ".\\myQueue" ) )
   {
      try
      {

         // Delete the queue.
         MessageQueue::Delete( ".\\myQueue" );
      }
      catch ( MessageQueueException^ e ) 
      {
         if ( e->MessageQueueErrorCode == MessageQueueErrorCode::AccessDenied )
         {
            Console::WriteLine( "Access is denied. Queue might be a system queue." );
         }

         // Handle other sources of MessageQueueException.
      }

   }

   return 0;
}

.NET Framework
Available since 1.1
Return to top
Show: