Share via

3.10.4.1.20 ModifyTime (Opnum 26)

  • Article

The ModifyTime method is received by the server in an RPC_REQUEST packet. In response, the server returns the latest date and time when one of the properties of the referenced queue was updated.

 [propget] HRESULT ModifyTime(
   [out, retval] VARIANT* pvarModifyTime
 );

pvarModifyTime: A pointer to a VARIANT that contains a UTC date/time (VT_DATE) that specifies the latest date and time when one of properties of the referenced queue was updated.

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

When processing this call, the server MUST abide by the following contract:

  • If IsRefreshed is FALSE call Refresh (section 3.10.4.1.29).

  • If Refresh returns a value other than S_OK (0x00000000), return the HRESULT returned by Refresh and take no further action.

  • If IsApplicationQueue is True:

    • Set the pvarModifyTime output parameter to the value of refQueue.ModifyTime.

  • Else:

    • Set the pvarModifyTime output parameter to the value of time_t zero (0x00000000), equivalent to VARIANT DateTime Midnight, January 1st, 1970 UTC.

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