MQSetQueueProperties

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets the properties of a local queue.

Syntax

HRESULT APIENTRY MQSetQueueProperties(
  LPCWSTR lpwcsFormatName,
  MQQUEUEPROPS* pQueueProps
);

Parameters

• lpwcsFormatName
  [in] Pointer to the direct format name string of the queue whose properties will be set.

• pQueueProps
  [in] Pointer to the MQQUEUEPROPS structure that specifies the properties to be set.

  On input, the cProp member of MQQUEUEPROPS specifies the number of properties to be set, the aPropID array specifies their property identifiers, and the aPropVar array indicates the new values of the specified properties.

  On output, the optional aStatus array, if it was included in MQQUEUEPROPS, indicates the status of the properties.

Return Value

• MQ_OK
  Indicates success.

• MQ_ERROR_ILLEGAL_FORMATNAME
  The lpwcsFormatName parameter specified an illegal format name.

• MQ_ERROR_ILLEGAL_PROPERTY_VALUE
  An illegal property value is specified.

• MQ_ERROR_PROPERTY
  One or more properties resulted in an error.

• MQ_ERROR_SERVICE_NOT_AVAILABLE
  Cannot connect to the Queue Manager.

• MQ_ERROR_UNSUPPORTED_FORMATNAME_OPERATION
  The format name specified by the lpwcsFormatName parameter cannot be used.

  You cannot set the queue properties of a journal, dead-letter, or connector queue.

• MQ_INFORMATION_PROPERTY
  One or more properties resulted in a warning even though the function completed.

Remarks

The following queue properties cannot be set by MQSetQueueProperties.

Property	Reason
PROPID_Q_CREATE_TIME	Set by MSMQ.
PROPID_Q_MODIFY_TIME	Set by MSMQ.
PROPID_Q_PATHNAME	Can only be set when the queue is created.
PROPID_Q_TRANSACTION	Can only be set when the queue is created.

Note

OS versions prior to 2.12 require the MSMQ add-on pack.

Requirements

Header	mq.h
Library	msmqrt.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later
Note	Versions prior to 2.12 require the MSMQ add-on pack

See Also

Reference

aPropID
aPropVar
aStatus
PROPID_Q_CREATE_TIME
PROPID_Q_MODIFY_TIME
PROPID_Q_PATHNAME
PROPID_Q_TRANSACTION
MQQUEUEPROPS