Share via


MQLocateEnd

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

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 (0xC00E0007)

The query handle specified in hEnum is not valid.

Remarks

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

For information on See
What information Message Queuing needs to locate queues Locating Queues Using Function Calls
Structures used to set search criteria Specifying Search Criteria
Structures used to set returned queue properties Specifying Queue Properties to Retrieve

Example Code

The following code example is included in Using Message Queuing.

For an example of See
Locating queues based on queue label C++ Code Example: Locating a Queue

Requirements

Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later.

Windows 95/98/Me: Included in Windows 95 and later.

Header: Declared in Mq.h.

Library: Use Mqrt.lib.

See Also

Message Queuing Functions
MQLocateBegin