MQLocateEnd

The MQLocateEnd function ends a query, releasing the resources associated with the query.

HRESULT APIENTRY MQLocateEnd(
  HANDLE hEnum  
);
 

Parameters

hEnum

[in] Query handle returned by a call to MQLocateBegin.

Return Values

MQ_OK

Indicates success.

MQ_ERROR_INVALID_HANDLE

The query handle specified in hEnum is not valid.

Remarks

MQLocateEnd is not supported if there is no connection to Active Directory. This restriction applies to dependent client computers, independent client computers (working offline), and MSMQ routing servers (FRS). (For information on offline operations, see MSMQ Offline Support.)

Examples

For an example of using MQLocateEnd, see Locating a Public Queue.

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mq.h.
  Import Library: Use mqrt.lib.
  Unicode: Defined only as Unicode.

See Also

MQLocateBegin, MQLocateNext