3.16.4.3.2 FireArrivedEvent (Opnum 8)

  • Article

The FireArrivedEvent method is received by the server in an RPC_REQUEST packet. In response, the server MUST provide notification of the availability of a Message.

 HRESULT FireArrivedEvent(
   [in] IMSMQQueue* pq,
   [in] long msgcursor
 );

pq: A pointer to an IMSMQQueue interface that upon success will be cast to an IDispatch pointer.

msgcursor: A long value that specifies the value of the cursor option that was specified through the Cursor input parameter that was passed to the IMSMQQueue4::EnableNotification operation to associate this MSMQEvent with MSMQQueue. This parameter corresponds to the MQMSGCURSOR (section 2.2.2.8) enum.

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:

  • Cast pq to an IDispatch pointer pq1.

  • Call the _DMSMQEventEvents::Arrived method with the following inputs:

    • Queue = pq

    • Cursor = msgcursor