Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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.Ackand AdminQueueInfowhen sending messages.

To find out if acknowledgment messages were requested, the receiving application can examine MSMQMessage.Ackand AdminQueueInfowhen 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