Partager via


MSMQMessage.AdminQueueInfo (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

MSMQMessage
MSMQMessage.Ack
MSMQQueueInfo
MSMQQueueInfo.Refresh
PROPID_M_ADMIN_QUEUE