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 method updates the directory service, the public queues, or the local computer, the private queues, with the current property values of the MSMQQueueInfoobject.

Syntax 

HRESULT Update(void);

Parameters

None.

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 MSMQQueueInfo.Updatemethod can update the property values of existing public and local private queues. It cannot be called on an MSMQQueueInfoobject before the queue is created or after the queue is deleted.

Message Queuing updates queue property values in these circumstances:

  • When a queue is created.

  • When a queue is opened.

  • When MSMQQueueInfo.Updateis explicitly called.

Calling MSMQQueueInfo.Update

When MSMQQueueInfo.Updateis called, the local queue property values of the MSMQQueueInfoobject are stored in one of two places:

  • For public queues, these property values are stored in the directory service.

  • For private queues, these property values are stored on the local computer.

Queue Properties that cannot be Updated

The MSMQQueueInfo.Updatemethod cannot update the following queue properties.

Propagation Delays

When setting the properties of a public queue, some clients might still see the old settings registered in the directory service after the properties are changed.

Changes to the directory service (such as setting properties) are propagated from domain controller to domain controller, which can cause delays in the availability of new information.

Consequently, clients using a specific domain controller might still see the old property settings, even though the settings of the properties were changed by Update.

Propagation delays, including communication network delays such as down links, are controlled by the MSMQ Administrator.

Equivalent Function

To set the properties of a queue using function calls, see the MQSetQueuePropertiesfunction.

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