Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This property indicates the share mode of the queue.
HRESULT get_ShareMode( long* plShareMode);
Parameters
- plShareMode
Share mode of the queue. The following table shows the possible values.Value Description MQ_DENY_NONE The queue is available to everyone for sending, peeking at, or retrieving messages. This is returned if the queue is opened with Access set to MQ_PEEK_ACCESS or MQ_SEND_ACCESS.
MQ_DENY_RECEIVE_SHARE Messages can only be retrieved by this process. This value is returned if the queue is opened with Access set to MQ_RECEIVE_ACCESS.
Return Values
The following table describes the common return values.
| Value | Description |
|---|---|
| S_OK | Success |
| E_INVALIDARG | One or more arguments are invalid |
| E_NOTIMPL | The function contains no implementation |
| E_OUTOFMEMORY | Out of memory |
Remarks
The ShareMode property returns the share mode of the queue when it was last opened, regardless if the queue is open or closed.
When ShareMode returns MQ_DENY_NONE, several users can be using the queue at the same time.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Mqoai.h.
Link Library: Mqoa.lib.
Send Feedback on this topic to the authors