MSMQMessage.AdminQueueInfo
A version of this page is also available for
4/8/2010
This property specifies the queue used for MSMQ-generated acknowledgment messages. This object is passed to the queue manager on the target machine.
Syntax
HRESULT get_AdminQueueInfo(
MSMQQueueInfo** ppinfoAdmin
);
HRESULT putref_AdminQueueInfo(
MSMQQueueInfo* pinfoAdmin
);
Parameters
- ppinfoAdminor pinfoAdmin
Queue information object that represents the administration queue.
Return Value
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 administration queue can be any nontransactional queue.
The acknowledgment messages sent to the queue can indicate whether or not the original message reached its destination queue or whether or not it was removed from the queue.
Acknowledgment messages are generated and sent by MSMQ.
To request acknowledgment messages, the sending application must set MSMQMessage.Ack and AdminQueueInfo when sending messages.
To find out if acknowledgment messages were requested, the receiving application can examine MSMQMessage.Ack and AdminQueueInfo when it reads the messages in the queue.
You can also set and retrieve the administration queue when using Message Queuing function calls.
Requirements
| Header | mqoai.h |
| Library | mqoa.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
MSMQMessage
MSMQMessage.Ack
MSMQQueueInfo
MSMQQueueInfo.Refresh
PROPID_M_ADMIN_QUEUE