Share via

3.11.4.1.10 Reset (Opnum 16)

  • Article

The Reset method is received by the server in an RPC_REQUEST packet. In response, the server resets the cursor that is represented by the Cursor instance variable to the Uninitialized state.

 HRESULT Reset();

This method has no parameters.

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST follow these guidelines:

  • If the IsInitialized instance variable is False:

    • Return an error OLE_E_BLANK (0x80040007), and take no further action.

  • If the IsClosed instance variable equals True:

    • Return an error MQ_ERROR_INVALID_HANDLE (0xC00E0007), and take no further action.

  • Set the cursor that is represented by the Cursor instance variable to the Uninitialized state.

  • Return S_OK (0x00000000), and take no further action.