MSMQMessage.AdminQueueInfo (Compact 2013)

3/26/2014

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

See Also

Reference

MSMQMessage
MSMQMessage.Ack
MSMQQueueInfo
MSMQQueueInfo.Refresh
PROPID_M_ADMIN_QUEUE