Share via


MQCloseCursor (Windows CE 5.0)

Send Feedback

This function closes a specific cursor, allowing Message Queuing (MSMQ) to release the associated resources.

HRESULT APIENTRY MQCloseCursor(HANDLE hCursor);

Parameters

  • hCursor
    [in] Handle to the cursor you want to close.

Return Values

  • MQ_OK
    Indicates success.
  • MQ_ERROR_INVALID_HANDLE
    The cursor handle specified in hCursor is not valid.

Remarks

Typically, cursors are closed by calling MQCloseCursor. However, MSMQ closes any cursor created for a queue when that queue is closed.

MQCloseCursor returns MQ_ERROR_INVALID_HANDLE when an attempt is made to close a cursor that has been closed by MSMQ.

To create a cursor, call MQCreateCursor.

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

MQCreateCursor | MQOpenQueue

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.