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.