MessageQueue::DenySharedReceive Property

 

Gets or sets a value that indicates whether this MessageQueue has exclusive access to receive messages from the Message Queuing queue.

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

public:
[BrowsableAttribute(false)]
[MessagingDescriptionAttribute("MQ_DenySharedReceive")]
property bool DenySharedReceive {
	bool get();
	void set(bool value);
}

Property Value

Type: System::Boolean

true if this MessageQueue has exclusive rights to receive messages from the queue; otherwise, false. The default is false.

DenySharedReceive specifies the shared mode of the queue referenced by this MessageQueue. Set DenySharedReceive to true to indicate that only this MessageQueue should have access to peek or receive messages from the queue with the specified Path. If another MessageQueue or another application is associated with the same queue resource, that instance or application will not be able to peek or receive messages, but it can still send them.

If DenySharedReceive is false, the queue is available to multiple applications for sending, peeking, or receiving messages.

The following table shows whether this property is available in various Workgroup modes.

Workgroup mode

Available

Local computer

Yes

Local computer and direct format name

Yes

Remote computer

Yes

Remote computer and direct format name

Yes

The following code example gets and sets the value of a message queue's DenySharedReceive property.

// Set the queue's DenySharedReceive property value.
queue.DenySharedReceive = false;

// Display the new value of the queue's DenySharedReceive property.
Console.WriteLine("MessageQueue.DenySharedReceive: {0}",
    queue.DenySharedReceive);

.NET Framework
Available since 1.1
Return to top
Show: