NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

MessageQueue.Authenticate

Gets or sets a value specifying whether the queue only accepts authenticated messages.

[Visual Basic]
Overridable Public Property Authenticate As Boolean
[C#]
public bool Authenticate {virtual get; virtual set;}
[C++]
public: __property virtual bool get_Authenticate();
public: __property virtual void set_Authenticate(bool);
[JScript]
public function get Authenticate() : Boolean;
public function set Authenticate(Boolean);

Property Value

true if the queue only accepts authenticated messages; otherwise, false.

Exceptions

Exception Type Condition
MessageQueueException The attempt to get or set the Authenticate setting generated an internal error on the message queue component. The error is specified by the given status message.

Remarks

When a non-authenticated message is sent to a queue that only accepts authenticated messages, the message is rejected. The sending application can request notification when a message is rejected by setting the AcknowledgeType on the message. There is no indication otherwise that the message was rejected, so the message can be lost unless you send it to the deadletter queue.

See Also

MessageQueue Class | MessageQueue Members | System.Messaging Namespace