MessageQueueErrorCode MessageQueueErrorCode MessageQueueErrorCode MessageQueueErrorCode Enum

Definition

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

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

public enum class MessageQueueErrorCode
[System.Serializable]
public enum MessageQueueErrorCode
type MessageQueueErrorCode = 
Public Enum MessageQueueErrorCode
Inheritance
MessageQueueErrorCodeMessageQueueErrorCodeMessageQueueErrorCodeMessageQueueErrorCode
Attributes

Fields

AccessDenied AccessDenied AccessDenied AccessDenied -1072824283

Message text: Access is denied.Access to the specified queue or computer is denied. If this error is returned, verify that you have access rights for the operation, such as creating, deleting, or setting properties for a queue. For information about changing access rights for a queue, see MessageQueueAccessRights and SetPermissions.

BadSecurityContext BadSecurityContext BadSecurityContext BadSecurityContext -1072824267

Message text: Bad security context.
The security context has become corrupted.

Base Base Base Base -1072824320

Message Queuing does not return this error code.

BufferOverflow BufferOverflow BufferOverflow BufferOverflow -1072824294

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 CannotCreateCertificateStore CannotCreateCertificateStore CannotCreateCertificateStore -1072824209

Message text: Unable to create a certificate store for the internal certificate.
Message Queuing returns this error if you do not have permission to manipulate your own profile.

CannotCreateHashEx CannotCreateHashEx CannotCreateHashEx CannotCreateHashEx -1072824191

Message text: Unable to create a hash object for an authenticated message.
See the Message class's HashAlgorithm property for more information about hash algorithms.

CannotCreateOnGlobalCatalog CannotCreateOnGlobalCatalog CannotCreateOnGlobalCatalog CannotCreateOnGlobalCatalog -1072824201

Message text: Failed to create an object on a specified global catalog server.

CannotGetDistinguishedName CannotGetDistinguishedName CannotGetDistinguishedName CannotGetDistinguishedName -1072824194

Message text: Failed to retrieve the distinguished name of local computer.

CannotGrantAddGuid CannotGrantAddGuid CannotGrantAddGuid CannotGrantAddGuid -1072824206

Message text: Failed to grant the "Add Guid" permission to current user.

CannotHashDataEx CannotHashDataEx CannotHashDataEx CannotHashDataEx -1072824193

Message text: Unable to hash data for an authenticated message.

CannotImpersonateClient CannotImpersonateClient CannotImpersonateClient CannotImpersonateClient -1072824284

Message text: The RPC server cannot impersonate the client application, hence security credentials could not be verified.
Message Queuing returns this error if the directory service server cannot impersonate the client application. This is necessary to verify the security credentials.

CannotJoinDomain CannotJoinDomain CannotJoinDomain CannotJoinDomain -1072824202

Message text: Failed to join Message Queuing enterprise on Windows 2000 domain.

CannotLoadMsmqOcm CannotLoadMsmqOcm CannotLoadMsmqOcm CannotLoadMsmqOcm -1072824205

Message text: Cannot load the MSMQOCM.DLL library.

CannotOpenCertificateStore CannotOpenCertificateStore CannotOpenCertificateStore CannotOpenCertificateStore -1072824208

Message text: Unable to open the certificates store for the internal certificate.
Message Queuing returns this error if you do not have permission to manipulate your own profile.

CannotSetCryptographicSecurityDescriptor CannotSetCryptographicSecurityDescriptor CannotSetCryptographicSecurityDescriptor CannotSetCryptographicSecurityDescriptor -1072824212

Message text: Unable to set the security descriptor for the cryptographic keys.
For information about cryptographic providers, see CryptographicProviderType and AuthenticationProviderType.

CannotSignDataEx CannotSignDataEx CannotSignDataEx CannotSignDataEx -1072824192

Message text: Unable to sign data before sending an authenticated message.
See the Message class's DigitalSignature property for more information about signing data.

CertificateNotProvided CertificateNotProvided CertificateNotProvided CertificateNotProvided -1072824211

Message text: A user attempted to send an authenticated message without a certificate.
Message Queuing returns this error if the sending application attempts to use security context information to authenticate a message, and the security context does not include a certificate. For more information about certificates, see the Message class's SenderCertificate property.

ComputerDoesNotSupportEncryption ComputerDoesNotSupportEncryption ComputerDoesNotSupportEncryption ComputerDoesNotSupportEncryption -1072824269

Message text: The computer does not support encryption operations.
Message Queuing returns this error when the application requests encryption and the computer (source or destination) does not support encryption operations. When this error is returned, the encryption operation fails. For more information about using encryption, see EncryptionRequired and EncryptionAlgorithm.

CorruptedInternalCertificate CorruptedInternalCertificate CorruptedInternalCertificate CorruptedInternalCertificate -1072824275

Message text: The internal Message Queuing certificate is corrupted.
This error applies only to Message Queuing 1.0.

CorruptedPersonalCertStore CorruptedPersonalCertStore CorruptedPersonalCertStore CorruptedPersonalCertStore -1072824271

Message text: The personal certificate store is corrupted.
Message Queuing returns this error when the Microsoft Internet Explorer personal certificate store is corrupted.

CorruptedQueueWasDeleted CorruptedQueueWasDeleted CorruptedQueueWasDeleted CorruptedQueueWasDeleted -1072824216

Message text: The.ini file for the queue in LQS was deleted because it was corrupted.

CorruptedSecurityData CorruptedSecurityData CorruptedSecurityData CorruptedSecurityData -1072824272

Message text: A cryptographic function has failed.

CouldNotGetAccountInfo CouldNotGetAccountInfo CouldNotGetAccountInfo CouldNotGetAccountInfo -1072824265

Message text: Could not get the account information for the user.

CouldNotGetUserSid CouldNotGetUserSid CouldNotGetUserSid CouldNotGetUserSid -1072824266

Message text: Could not get the SID information out of the thread token.
For more information about sender identifiers, see the Message class's SenderId property.

DeleteConnectedNetworkInUse DeleteConnectedNetworkInUse DeleteConnectedNetworkInUse DeleteConnectedNetworkInUse -1072824248

Message text: The connected network cannot be deleted; it is in use.
Message Queuing returns this error if it cannot delete the specified connected network because the network is defined in at least one other computer. Remove the connected network from all connected network lists and try again to delete it.

DependentClientLicenseOverflow DependentClientLicenseOverflow DependentClientLicenseOverflow DependentClientLicenseOverflow -1072824217

Message text: The number of dependent clients served by this Message Queuing server reached its upper limit.

DsError DsError DsError DsError -1072824253

Message text: Internal directory service error.

DsIsFull DsIsFull DsIsFull DsIsFull -1072824254

Message text: Directory service is full.
Message Queuing returns this error if the information store is full. This error applies only to Message Queuing 1.0.

DtcConnect DtcConnect DtcConnect DtcConnect -1072824244

Message text: Cannot connect to MS DTC.
Message Queuing returns this error if it is unable to connect to the Microsoft Distributed Transaction Coordinator.

EncryptionProviderNotSupported EncryptionProviderNotSupported EncryptionProviderNotSupported EncryptionProviderNotSupported -1072824213

Message text: The Cryptographic Service Provider is not supported by Message Queuing.

FailVerifySignatureEx FailVerifySignatureEx FailVerifySignatureEx FailVerifySignatureEx -1072824190

Message text: Signature of received message is not valid.

FormatNameBufferTooSmall FormatNameBufferTooSmall FormatNameBufferTooSmall FormatNameBufferTooSmall -1072824289

Message text: The format name buffer supplied to the API was too small to fit the format name.

Generic Generic Generic Generic -1072824319

Message text: Generic Error.
Message Queuing returns this error if it cannot identify a more specific source.

GuidNotMatching GuidNotMatching GuidNotMatching GuidNotMatching -1072824200

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 IllegalContext IllegalContext IllegalContext -1072824229

Message text: Invalid context parameter.

IllegalCriteriaColumns IllegalCriteriaColumns IllegalCriteriaColumns IllegalCriteriaColumns -1072824264

Message text: Invalid MQCOLUMNS parameter.
Message Queuing returns this error if you are using the MessagePropertyFilter class and have selected false for all Boolean values and zero (0) for all integer values.

IllegalCursorAction IllegalCursorAction IllegalCursorAction IllegalCursorAction -1072824292

Message text: MQ_ACTION_PEEK_NEXT specified to MQReceiveMessage can not be used with the current cursor position.
MoveNext cannot be used with the current cursor position.

IllegalEnterpriseOperation IllegalEnterpriseOperation IllegalEnterpriseOperation IllegalEnterpriseOperation -1072824207

Message text: The operation is invalid for a Message Queuing services object.

IllegalFormatName IllegalFormatName IllegalFormatName IllegalFormatName -1072824290

Message text: The given format name is invalid. For valid format name syntax options, see the MessageQueue class's FormatName property.

IllegalMessageProperties IllegalMessageProperties IllegalMessageProperties IllegalMessageProperties -1072824255

Message text: Illegal MQQMPROPS parameter, either null or with zero properties.
Illegal message properties, either null or with zero properties.

IllegalOperation IllegalOperation IllegalOperation IllegalOperation -1072824220

Message text: The operation is invalid on foreign message queuing systems.

IllegalPrivateProperties IllegalPrivateProperties IllegalPrivateProperties IllegalPrivateProperties -1072824197

The private properties parameter value is invalid. This may be because it has a null value or has zero properties specified.

IllegalPropertyId IllegalPropertyId IllegalPropertyId IllegalPropertyId -1072824263

Message text: Invalid property identifier value.

IllegalPropertySize IllegalPropertySize IllegalPropertySize IllegalPropertySize -1072824261

Message text: Illegal property buffer size.
Message Queuing returns this error if the specified buffer for the message identifier or correlation identifier is not the correct size. See the Message class's Id and CorrelationId properties for more information about message identifiers.

IllegalPropertyValue IllegalPropertyValue IllegalPropertyValue IllegalPropertyValue -1072824296

Message text: Invalid property value.

IllegalPropertyVt IllegalPropertyVt IllegalPropertyVt IllegalPropertyVt -1072824295

Message text: Invalid VARTYPE value.

IllegalQueuePathName IllegalQueuePathName IllegalQueuePathName IllegalQueuePathName -1072824300

Message text: Invalid queue path name.
See the MessageQueue class's Path property for valid path syntax options.

IllegalQueueProperties IllegalQueueProperties IllegalQueueProperties IllegalQueueProperties -1072824259

Message text: Illegal MQQUEUEPROPS parameter, either null or with zero properties.
Message Queuing returns this error if you are using the MessageQueueCriteria class and have called ClearAll() or have not specified any criteria to use when filtering queues. See the MessageQueueCriteria class or GetPublicQueues for more information about filtering queue search criteria.

IllegalRelation IllegalRelation IllegalRelation IllegalRelation -1072824262

Message text: Invalid relation value in restriction.

IllegalRestrictionPropertyId IllegalRestrictionPropertyId IllegalRestrictionPropertyId IllegalRestrictionPropertyId -1072824260

Message text: Invalid propid value in MQRESTRICTION parameter.
Invalid property identifier value for restriction.

IllegalSecurityDescriptor IllegalSecurityDescriptor IllegalSecurityDescriptor IllegalSecurityDescriptor -1072824287

Message text: The specified security descriptor is not a valid security descriptor.

IllegalSort IllegalSort IllegalSort IllegalSort -1072824304

Message text: Illegal sort specified (for example, duplicate columns).

IllegalSortPropertyId IllegalSortPropertyId IllegalSortPropertyId IllegalSortPropertyId -1072824228

Message text: Invalid propid value in MQSORTSET.
Invalid property identifier value in for sort.

IllegalUser IllegalUser IllegalUser IllegalUser -1072824303

Message text: The user has an invalid user name.
Message Queuing returns this error if your application is connecting to it through an invalid user name.

InsufficientProperties InsufficientProperties InsufficientProperties InsufficientProperties -1072824257

Message text: Not all the required properties for the operation were specified in the input parameters.

InsufficientResources InsufficientResources InsufficientResources InsufficientResources -1072824281

Message text: Insufficient resources to perform operation.
Message Queuing returns this error, for example, if there is not enough memory to complete the operation. When this error is returned, the operation fails.

InvalidCertificate InvalidCertificate InvalidCertificate InvalidCertificate -1072824276

Message text: The user certificate is not valid.
Message Queuing returns this error if the security certificate specified in the Message class's SenderCertificate property is invalid, or if the certificate is not correctly placed in the Microsoft Internet Explorer personal certificate store.

InvalidHandle InvalidHandle InvalidHandle InvalidHandle -1072824313

Message text: An invalid handle passed to a function.
Message Queuing returns this error if the specified queue handle is not valid.

InvalidOwner InvalidOwner InvalidOwner InvalidOwner -1072824252

Message text: Invalid object owner. For example CreateQueue failed because the Queue Manager object is invalid.
Message Queuing returns this error, for example, if your application attempts to create a queue on a computer on which Message Queuing is not installed.

InvalidParameter InvalidParameter InvalidParameter InvalidParameter -1072824314

Message text: An invalid parameter passed to a function.
Message Queuing returns this error if one of the parameters supplied by the operation is not valid.

IOTimeout IOTimeout IOTimeout IOTimeout -1072824293

Message text: The receive or peek message time-out has expired.
Message Queuing returns this error if the time-out specified in a call to Receive or Peek expires before a new message arrives in the queue. This can only happen if there was no message already in the queue; both methods would return immediately if a message exists.

LabelBufferTooSmall LabelBufferTooSmall LabelBufferTooSmall LabelBufferTooSmall -1072824226

Message text: The label buffer supplied to the API was too small.

MachineExists MachineExists MachineExists MachineExists -1072824256

Message text: Computer with the same name already exists in the site.

MachineNotFound MachineNotFound MachineNotFound MachineNotFound -1072824307

Message text: The specified computer could not be found.
Message Queuing returns this error if it cannot find the queue's computer in the directory service.

MessageAlreadyReceived MessageAlreadyReceived MessageAlreadyReceived MessageAlreadyReceived -1072824291

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.
Message Queuing returns this error when some other cursor, application, or the system administrator has already removed the message from the queue. This error is most likely to occur when using the MessageEnumerator class, such as the instance returned through a call to GetMessageEnumerator2() or GetEnumerator().

MessageNotFound MessageNotFound MessageNotFound MessageNotFound -1072824184

Message text: The specified message could not be found.
Message Queuing returns this error if it cannot find the specified message in the queue.

MessageStorageFailed MessageStorageFailed MessageStorageFailed MessageStorageFailed -1072824278

Message text: Could not store a recoverable or journal message. Message was not sent.
Message Queuing returns this error if the local computer cannot store a recoverable message (one whose delivery is guaranteed in the case of a network problem) or a journal message. See the Message class's Recoverable and UseJournalQueue properties for more information about these message sending options.

MissingConnectorType MissingConnectorType MissingConnectorType MissingConnectorType -1072824235

Message text: Connector Type is mandatory when sending an Acknowledgment or secure message.
Message Queuing returns this error when the application sets a property typically set by Message Queuing, but does not specify the connector to use. For more information about connector types, see the Message class's ConnectorType property.

MqisReadOnlyMode MqisReadOnlyMode MqisReadOnlyMode MqisReadOnlyMode -1072824224

Message text: MQIS database is in read-only mode.

MqisServerEmpty MqisServerEmpty MqisServerEmpty MqisServerEmpty -1072824225

Message text: The list of MQIS servers (in registry) is empty. This error applies only to Message Queuing 1.0.

NoDs NoDs NoDs NoDs -1072824301

Message text: No connection with this site's controller(s).
Message Queuing returns this error if the application cannot access the directory service. If this error is returned, verify permissions for accessing the directory service.

NoEntryPointMsmqOcm NoEntryPointMsmqOcm NoEntryPointMsmqOcm NoEntryPointMsmqOcm -1072824204

Message text: Cannot locate an entry point in the MSMQOCM.DLL library.

NoGlobalCatalogInDomain NoGlobalCatalogInDomain NoGlobalCatalogInDomain NoGlobalCatalogInDomain -1072824196

Message text: Unable to find Global Catalog servers in the specified domain.

NoInternalUserCertificate NoInternalUserCertificate NoInternalUserCertificate NoInternalUserCertificate -1072824273

Message text: The internal Message Queuing certificate for the user does not exist.
Message Queuing returns this error if no internal certificate is registered or the registered certificate is corrupted.

NoMsmqServersOnDc NoMsmqServersOnDc NoMsmqServersOnDc NoMsmqServersOnDc -1072824203

Message text: Failed to find Message Queuing servers on domain controllers.

NoMsmqServersOnGlobalCatalog NoMsmqServersOnGlobalCatalog NoMsmqServersOnGlobalCatalog NoMsmqServersOnGlobalCatalog -1072824195

Message text: Failed to find Message Queuing servers on Global Catalog domain controllers.

NoResponseFromObjectServer NoResponseFromObjectServer NoResponseFromObjectServer NoResponseFromObjectServer -1072824247

Message text: No response from object owner.
Message Queuing returns this error if there is no response from the directory service server. When this error is returned, the status of the operation is unknown.

ObjectServerNotAvailable ObjectServerNotAvailable ObjectServerNotAvailable ObjectServerNotAvailable -1072824246

Message text: Object owner is not reachable.
Message Queuing returns this error if the directory service server for the object is not available. When this error is returned, the operation fails.

OperationCanceled OperationCanceled OperationCanceled OperationCanceled -1072824312

Message text: The operation was canceled before it could be completed.

PrivilegeNotHeld PrivilegeNotHeld PrivilegeNotHeld PrivilegeNotHeld -1072824282

Message text: Client does not have the required privileges to perform the operation.

Property Property Property Property -1072824318

Message text: One or more of the passed properties are invalid.

PropertyNotAllowed PropertyNotAllowed PropertyNotAllowed PropertyNotAllowed -1072824258

Message text: Invalid property for the requested operation

ProviderNameBufferTooSmall ProviderNameBufferTooSmall ProviderNameBufferTooSmall ProviderNameBufferTooSmall -1072824221

Message text: The passed buffer for the Provider name property is too small.
See the Message class's AuthenticationProviderName property for more information about provider names.

PublicKeyDoesNotExist PublicKeyDoesNotExist PublicKeyDoesNotExist PublicKeyDoesNotExist -1072824198

Message text: The public key for the computer does not exist.
Message Queuing returns this error if it was able to query the directory service, but the enhanced key was not found. This error applies only to Message Queuing 2.0.

PublicKeyNotFound PublicKeyNotFound PublicKeyNotFound PublicKeyNotFound -1072824199

Message text: Unable to find the public key for computer.
Message Queuing returns this error, for example, if you are trying to retrieve the computer properties of a computer running Message Queuing 1.0 or if you are trying to get remote computer properties while working offline. This error applies only to Message Queuing 2.0.

QDnsPropertyNotSupported QDnsPropertyNotSupported QDnsPropertyNotSupported QDnsPropertyNotSupported -1072824210

DNS property is not supported as criteria to locate queues.
You cannot retrieve the DNS path name of a queue.

QueueDeleted QueueDeleted QueueDeleted QueueDeleted -1072824230

Message text: The queue was deleted. Messages cannot be received anymore using this queue instance. The queue should be closed.

QueueExists QueueExists QueueExists QueueExists -1072824315

Message text: A queue with the same pathname is already registered.
Message Queuing registers public queues in the directory service, and registers private queues on the local computer.

QueueNotAvailable QueueNotAvailable QueueNotAvailable QueueNotAvailable -1072824245

Message text: Error while reading from a queue residing on a remote computer.

QueueNotFound QueueNotFound QueueNotFound QueueNotFound -1072824317

Message text: The queue is not registered in the directory service.
Message Queuing returns this error if it cannot find the queue. This includes public queues not registered in the directory service and Internet queues that do not exist in the Message Queuing namespace.

RemoteMachineNotAvailable RemoteMachineNotAvailable RemoteMachineNotAvailable RemoteMachineNotAvailable -1072824215

Message text: The remote machine is not available.

ResultBufferTooSmall ResultBufferTooSmall ResultBufferTooSmall ResultBufferTooSmall -1072824250

Message text: The supplied result buffer is too small.

SecurityDescriptorBufferTooSmall SecurityDescriptorBufferTooSmall SecurityDescriptorBufferTooSmall SecurityDescriptorBufferTooSmall -1072824285

Message text: The size of the buffer passed to MQGetQueueSecurity is too small.
Message Queuing returns this error if the supplied security buffer is too small for the security descriptor.

SenderCertificateBufferTooSmall SenderCertificateBufferTooSmall SenderCertificateBufferTooSmall SenderCertificateBufferTooSmall -1072824277

Message text: The passed buffer for the user certificate property is too small.
See the Message class's SenderCertificate property for more information about user certificates.

SenderIdBufferTooSmall SenderIdBufferTooSmall SenderIdBufferTooSmall SenderIdBufferTooSmall -1072824286

Message text: The passed buffer for the user identifier property is too small.
Message Queuing returns this error when the supplied sender identification buffer is too small. See the Message class's SenderId property for more information about sender identifiers.

ServiceNotAvailable ServiceNotAvailable ServiceNotAvailable ServiceNotAvailable -1072824309

Message text: The Message Queues service is not available.
Message Queuing returns this error if the application is unable to connect to the Queue Manager.

SharingViolation SharingViolation SharingViolation SharingViolation -1072824311

Message text: Sharing violation. The queue is already opened for exclusive receive.
Message Queuing returns this error if an application is trying to open an already opened queue that has exclusive read rights. For more information about receiving messages exclusively from a queue, see the MessageQueue class's DenySharedReceive property.

SignatureBufferTooSmall SignatureBufferTooSmall SignatureBufferTooSmall SignatureBufferTooSmall -1072824222

Message text: The passed buffer for the Signature property is too small.
See the Message class's DigitalSignature property for more information about signatures.

StaleHandle StaleHandle StaleHandle StaleHandle -1072824234

Message text: The Queue Manager service has been restarted. The queue handle is stale and should be closed.
Message Queuing returns this error if the specified handle was obtained in a previous session of the Queue Manager service.

SymmetricKeyBufferTooSmall SymmetricKeyBufferTooSmall SymmetricKeyBufferTooSmall SymmetricKeyBufferTooSmall -1072824223

Message text: The passed buffer for the Symmetric key property is too small.
See the Message class's DestinationSymmetricKey property for more information about symmetric keys.

TransactionEnlist TransactionEnlist TransactionEnlist TransactionEnlist -1072824232

Message text: Cannot enlist the transaction.

TransactionImport TransactionImport TransactionImport TransactionImport -1072824242

Message text: Cannot import the transaction.

TransactionSequence TransactionSequence TransactionSequence TransactionSequence -1072824239

Message text: Wrong transaction operations sequence.

TransactionUsage TransactionUsage TransactionUsage TransactionUsage -1072824240

Message text: Wrong transaction usage.
Message Queuing returns this error if an attempt was made to open a remote queue for read access from within a transaction, or an attempt was made to read a message from a non-transactional queue from within a transaction.

UnsupportedAccessMode UnsupportedAccessMode UnsupportedAccessMode UnsupportedAccessMode -1072824251

Message text: The specified access mode is not supported.
Message Queuing returns this error if 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.

UnsupportedFormatNameOperation UnsupportedFormatNameOperation UnsupportedFormatNameOperation UnsupportedFormatNameOperation -1072824288

Message text: The requested operation for the specified format name is not supported.
Message Queuing returns this error when the requested operation is not supported for the specified format name. Operations include trying to open a queue to receive messages by specifying a direct format name.

UnsupportedOperation UnsupportedOperation UnsupportedOperation UnsupportedOperation -1072824214

Message text: The operation is not supported for a WORKGROUP installation computer.

UserBufferTooSmall UserBufferTooSmall UserBufferTooSmall UserBufferTooSmall -1072824280

Message text: Request failed because user buffer is too small to hold the returned information.

WksCantServeClient WksCantServeClient WksCantServeClient WksCantServeClient -1072824218

Message text: Message Queuing-independent clients cannot serve Message Queuing-dependent clients.

WriteNotAllowed WriteNotAllowed WriteNotAllowed WriteNotAllowed -1072824219

Message text: Another MQIS server is being installed; write operations to the database are not allowed at this time.

Examples

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

#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;
}

using System;
using System.Messaging;

namespace MyProject
{
    /// <summary>
    /// Provides a container class for the example.
    /// </summary>
    public class MyNewQueue
    {

        //**************************************************
        // Provides an entry point into the application.
        //		 
        // This example verifies existence and attempts to 
        // delete a queue.
        //**************************************************

        public static void 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;
        }

    }
}
Imports System.Messaging



Public Class MyNewQueue


        
        ' Provides an entry point into the application.
        '		 
        ' This example verifies existence and attempts to 
        ' delete a queue.
        

        Public Shared Sub Main()

            ' Determine whether the queue exists.
            If MessageQueue.Exists(".\myQueue") Then

                Try

                    ' Delete the queue.
                    MessageQueue.Delete(".\myQueue")

                Catch e As MessageQueueException

                    If e.MessageQueueErrorCode = _
                        MessageQueueErrorCode.AccessDenied Then

                        Console.WriteLine("Access is denied. " _
                            + "Queue might be a system queue.")
                    End If

                    ' Handle other sources of exceptions as necessary.

                End Try

            End If


            Return

        End Sub

End Class

Remarks

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.

Applies to

See also