Share via

MQGetMachineProperties (Windows CE 5.0)

  • Article

Send Feedback

This function retrieves information about a Queue Manager on the local machine.

HRESULT APIENTRY MQGetMachineProperties(LPCWSTR lpwcsMachineName,const GUID* pguidMachineID,MQQMPROPS* pQMProps);

Parameters

  • lpwcsMachineName
    [in] Not supported; set to NULL.
  • pguidMachineID
    [in] Not supported; set to NULL.
  • pQMProps
    [in, out] Pointer to a Queue Manager properties structure, MQQMPROPS, specifying which properties to retrieve.

Return Values

  • MQ_OK
    Indicates success.

  • MQ_ERROR_ACCESS_DENIED
    Access to the specified computer is denied.

    Verify the access rights for the operation.

  • MQ_ERROR_INVALID_PARAMETER
    Both the name (lpwcsMachineName) and computer (pguidMachineID) identifiers were specified.

  • MQ_ERROR_ILLEGAL_MQQMPROPS
    Either pQMprops was NULL or no properties were specified.

  • MQ_ERROR_ILLEGAL_PROPERTY_VT
    An invalid type indicator was supplied for a property value in pQMProps.

  • MQ_INFORMATION_UNSUPPORTED_PROPERTY
    An unsupported property identifier was specified in pQMProps.

  • MQ_INFORMATION_DUPLICATE_PROPERTY
    A duplicate property identifier was specified in pQMProps. The second entry is ignored.

Remarks

For Windows CE, the only valid Queue Manager property is PROPID_QM_MACHINE_ID.

If a property specified by pQMProps is set to VT_NULL, MSMQ allocates the memory needed to store the property value when MQGetMachineProperties is called.

If the returned property type replaces the VT_NULL value, the application must free the memory allocated for the property value by calling MQFreeMemory.

Requirements

OS Versions: Windows CE 2.0 and later. Versions prior to 2.12 require the MSMQ add-on pack.
Header: Mq.h.
Link Library: Msmqrt.lib.

See Also

MQFreeMemory | PROPID_QM_MACHINE_ID | MQQMPROPS

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.