MessageQueueErrorCode Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 MessageQueueErrorCodepublic enum MessageQueueErrorCode[System.Serializable]
public enum MessageQueueErrorCodetype MessageQueueErrorCode = [<System.Serializable>]
type MessageQueueErrorCode = Public Enum MessageQueueErrorCode- Inheritance
- Attributes
Fields
| 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 | -1072824267 | Message text: Bad security context. |
| Base | -1072824320 | Message Queuing does not return this error code. |
| 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 | -1072824209 | Message text: Unable to create a certificate store for the internal certificate. |
| CannotCreateHashEx | -1072824191 | Message text: Unable to create a hash object for an authenticated message. |
| CannotCreateOnGlobalCatalog | -1072824201 | Message text: Failed to create an object on a specified global catalog server. |
| CannotGetDistinguishedName | -1072824194 | Message text: Failed to retrieve the distinguished name of local computer. |
| CannotGrantAddGuid | -1072824206 | Message text: Failed to grant the "Add Guid" permission to current user. |
| CannotHashDataEx | -1072824193 | Message text: Unable to hash data for an authenticated message. |
| CannotImpersonateClient | -1072824284 | Message text: The RPC server cannot impersonate the client application, hence security credentials could not be verified. |
| CannotJoinDomain | -1072824202 | Message text: Failed to join Message Queuing enterprise on Windows 2000 domain. |
| CannotLoadMsmqOcm | -1072824205 | Message text: Cannot load the MSMQOCM.DLL library. |
| CannotOpenCertificateStore | -1072824208 | Message text: Unable to open the certificates store for the internal certificate. |
| CannotSetCryptographicSecurityDescriptor | -1072824212 | Message text: Unable to set the security descriptor for the cryptographic keys. |
| CannotSignDataEx | -1072824192 | Message text: Unable to sign data before sending an authenticated message. |
| CertificateNotProvided | -1072824211 | Message text: A user attempted to send an authenticated message without a certificate. |
| ComputerDoesNotSupportEncryption | -1072824269 | Message text: The computer does not support encryption operations. |
| CorruptedInternalCertificate | -1072824275 | Message text: The internal Message Queuing certificate is corrupted. |
| CorruptedPersonalCertStore | -1072824271 | Message text: The personal certificate store is corrupted. |
| CorruptedQueueWasDeleted | -1072824216 | Message text: The.ini file for the queue in LQS was deleted because it was corrupted. |
| CorruptedSecurityData | -1072824272 | Message text: A cryptographic function has failed. |
| CouldNotGetAccountInfo | -1072824265 | Message text: Could not get the account information for the user. |
| CouldNotGetUserSid | -1072824266 | Message text: Could not get the SID information out of the thread token. |
| DeleteConnectedNetworkInUse | -1072824248 | Message text: The connected network cannot be deleted; it is in use. |
| DependentClientLicenseOverflow | -1072824217 | Message text: The number of dependent clients served by this Message Queuing server reached its upper limit. |
| DsError | -1072824253 | Message text: Internal directory service error. |
| DsIsFull | -1072824254 | Message text: Directory service is full. |
| DtcConnect | -1072824244 | Message text: Cannot connect to MS DTC. |
| EncryptionProviderNotSupported | -1072824213 | Message text: The Cryptographic Service Provider is not supported by Message Queuing. |
| FailVerifySignatureEx | -1072824190 | Message text: Signature of received message is not valid. |
| FormatNameBufferTooSmall | -1072824289 | Message text: The format name buffer supplied to the API was too small to fit the format name. |
| Generic | -1072824319 | Message text: Generic Error. |
| 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 | -1072824229 | Message text: Invalid context parameter. |
| IllegalCriteriaColumns | -1072824264 | Message text: Invalid MQCOLUMNS parameter. |
| IllegalCursorAction | -1072824292 | Message text: MQ_ACTION_PEEK_NEXT specified to MQReceiveMessage can not be used with the current cursor position. |
| IllegalEnterpriseOperation | -1072824207 | Message text: The operation is invalid for a Message Queuing services object. |
| IllegalFormatName | -1072824290 | Message text: The given format name is invalid. For valid format name syntax options, see the MessageQueue class's FormatName property. |
| IllegalMessageProperties | -1072824255 | Message text: Illegal MQQMPROPS parameter, either null or with zero properties. |
| IllegalOperation | -1072824220 | Message text: The operation is invalid on foreign message queuing systems. |
| IllegalPrivateProperties | -1072824197 | The private properties parameter value is invalid. This may be because it has a null value or has zero properties specified. |
| IllegalPropertyId | -1072824263 | Message text: Invalid property identifier value. |
| IllegalPropertySize | -1072824261 | Message text: Illegal property buffer size. |
| IllegalPropertyValue | -1072824296 | Message text: Invalid property value. |
| IllegalPropertyVt | -1072824295 | Message text: Invalid VARTYPE value. |
| IllegalQueuePathName | -1072824300 | Message text: Invalid queue path name. |
| IllegalQueueProperties | -1072824259 | Message text: Illegal MQQUEUEPROPS parameter, either null or with zero properties. |
| IllegalRelation | -1072824262 | Message text: Invalid relation value in restriction. |
| IllegalRestrictionPropertyId | -1072824260 | Message text: Invalid propid value in MQRESTRICTION parameter. |
| IllegalSecurityDescriptor | -1072824287 | Message text: The specified security descriptor is not a valid security descriptor. |
| IllegalSort | -1072824304 | Message text: Illegal sort specified (for example, duplicate columns). |
| IllegalSortPropertyId | -1072824228 | Message text: Invalid propid value in MQSORTSET. |
| IllegalUser | -1072824303 | Message text: The user has an invalid user name. |
| InsufficientProperties | -1072824257 | Message text: Not all the required properties for the operation were specified in the input parameters. |
| InsufficientResources | -1072824281 | Message text: Insufficient resources to perform operation. |
| InvalidCertificate | -1072824276 | Message text: The user certificate is not valid. |
| InvalidHandle | -1072824313 | Message text: An invalid handle passed to a function. |
| InvalidOwner | -1072824252 | Message text: Invalid object owner. For example |
| InvalidParameter | -1072824314 | Message text: An invalid parameter passed to a function. |
| IOTimeout | -1072824293 | Message text: The receive or peek message time-out has expired. |
| LabelBufferTooSmall | -1072824226 | Message text: The label buffer supplied to the API was too small. |
| MachineExists | -1072824256 | Message text: Computer with the same name already exists in the site. |
| MachineNotFound | -1072824307 | Message text: The specified computer could not be found. |
| 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. |
| MessageNotFound | -1072824184 | Message text: The specified message could not be found. |
| MessageStorageFailed | -1072824278 | Message text: Could not store a recoverable or journal message. Message was not sent. |
| MissingConnectorType | -1072824235 | Message text: Connector Type is mandatory when sending an Acknowledgment or secure message. |
| MqisReadOnlyMode | -1072824224 | Message text: MQIS database is in read-only mode. |
| MqisServerEmpty | -1072824225 | Message text: The list of MQIS servers (in registry) is empty. This error applies only to Message Queuing 1.0. |
| NoDs | -1072824301 | Message text: No connection with this site's controller(s). |
| NoEntryPointMsmqOcm | -1072824204 | Message text: Cannot locate an entry point in the MSMQOCM.DLL library. |
| NoGlobalCatalogInDomain | -1072824196 | Message text: Unable to find Global Catalog servers in the specified domain. |
| NoInternalUserCertificate | -1072824273 | Message text: The internal Message Queuing certificate for the user does not exist. |
| NoMsmqServersOnDc | -1072824203 | Message text: Failed to find Message Queuing servers on domain controllers. |
| NoMsmqServersOnGlobalCatalog | -1072824195 | Message text: Failed to find Message Queuing servers on Global Catalog domain controllers. |
| NoResponseFromObjectServer | -1072824247 | Message text: No response from object owner. |
| ObjectServerNotAvailable | -1072824246 | Message text: Object owner is not reachable. |
| OperationCanceled | -1072824312 | Message text: The operation was canceled before it could be completed. |
| PrivilegeNotHeld | -1072824282 | Message text: Client does not have the required privileges to perform the operation. |
| Property | -1072824318 | Message text: One or more of the passed properties are invalid. |
| PropertyNotAllowed | -1072824258 | Message text: Invalid property for the requested operation. |
| ProviderNameBufferTooSmall | -1072824221 | Message text: The passed buffer for the Provider name property is too small. |
| PublicKeyDoesNotExist | -1072824198 | Message text: The public key for the computer does not exist. |
| PublicKeyNotFound | -1072824199 | Message text: Unable to find the public key for computer. |
| QDnsPropertyNotSupported | -1072824210 | DNS property is not supported as criteria to locate queues. |
| QueueDeleted | -1072824230 | Message text: The queue was deleted. Messages cannot be received anymore using this queue instance. The queue should be closed. |
| QueueExists | -1072824315 | Message text: A queue with the same pathname is already registered. |
| QueueNotAvailable | -1072824245 | Message text: Error while reading from a queue residing on a remote computer. |
| QueueNotFound | -1072824317 | Message text: The queue is not registered in the directory service. |
| RemoteMachineNotAvailable | -1072824215 | Message text: The remote machine is not available. |
| ResultBufferTooSmall | -1072824250 | Message text: The supplied result buffer is too small. |
| SecurityDescriptorBufferTooSmall | -1072824285 | Message text: The size of the buffer passed to |
| SenderCertificateBufferTooSmall | -1072824277 | Message text: The passed buffer for the user certificate property is too small. |
| SenderIdBufferTooSmall | -1072824286 | Message text: The passed buffer for the user identifier property is too small. |
| ServiceNotAvailable | -1072824309 | Message text: The Message Queues service is not available. |
| SharingViolation | -1072824311 | Message text: Sharing violation. The queue is already opened for exclusive receive. |
| SignatureBufferTooSmall | -1072824222 | Message text: The passed buffer for the Signature property is too small. |
| StaleHandle | -1072824234 | Message text: The Queue Manager service has been restarted. The queue handle is stale and should be closed. |
| SymmetricKeyBufferTooSmall | -1072824223 | Message text: The passed buffer for the Symmetric key property is too small. |
| TransactionEnlist | -1072824232 | Message text: Cannot enlist the transaction. |
| TransactionImport | -1072824242 | Message text: Cannot import the transaction. |
| TransactionSequence | -1072824239 | Message text: Wrong transaction operations sequence. |
| TransactionUsage | -1072824240 | Message text: Wrong transaction usage. |
| UnsupportedAccessMode | -1072824251 | Message text: The specified access mode is not supported. |
| UnsupportedFormatNameOperation | -1072824288 | Message text: The requested operation for the specified format name is not supported. |
| UnsupportedOperation | -1072824214 | Message text: The operation is not supported for a WORKGROUP installation computer. |
| UserBufferTooSmall | -1072824280 | Message text: Request failed because user buffer is too small to hold the returned information. |
| WksCantServeClient | -1072824218 | Message text: Message Queuing-independent clients cannot serve Message Queuing-dependent clients. |
| 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
Comentarios
Enviar y ver comentarios de