Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DeadLetterQueue Enumeration

Specifies the type of dead-letter queue to be used.

Namespace: System.ServiceModel
Assembly: System.ServiceModel (in system.servicemodel.dll)

public enum DeadLetterQueue
public enum DeadLetterQueue
public enum DeadLetterQueue

 Member nameDescription
CustomCustom dead-letter queue. 
NoneNo dead-letter queue is to be used. 
SystemUse the systemwide dead-letter queue. 

The dead-letter queue is a queue on the queue manager of the sending application for expired messages that have failed to be delivered. The DeadLetterQueue enumeration specifies the type of dead-letter queue to use. The values are:

  • None: No dead-letter queue is required. Thus, if a message were to fail delivery, no record of it would be maintained in the dead-letter queue. This is the default value when ExactlyOnce is set to false.

  • System: The systemwide dead-letter queue is used to record messages that fail delivery. MSMQ has a transactional system dead-letter queue and a nontransactional system dead-letter queue to record expired messages that failed delivery from transactional and nontransactional queues, respectively. This is the default value when ExactlyOnce is set to true.

  • Custom: The queue specified in the CustomDeadLetterQueue is used to record messages that fail delivery.

A message can fail to reach the receiving application for any of the following reasons:

  • A transactional message is sent to a nontransactional queue.

  • A nontransactional message is sent to a transactional queue.

  • An unauthenticated message is sent to a queue that accepts only authenticated messages.

  • An unencrypted message is sent to a queue that accepts only encrypted messages.

  • The message's time-to-live value expires before the message is delivered to a receiver.

  • The message storage quota of the target computer or the storage quota of the destination queue is exceeded, or there is no available storage space on the target computer when the message arrives.

  • The sender does not have the access rights needed to place the message in the destination queue.

  • The digital signature attached to the message is not valid.

  • An encrypted message cannot be decrypted by the destination queue manager.

  • The destination queue is purged or deleted before the message is retrieved.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft