3.2.4.2.48.13 Notifications (get) (Opnum 23)

The Notifications (get) method retrieves the notification periods for the file management job and returns S_OK upon successful completion.

 [propget, id(FSRM_PROPERTY(FSRM_DISPID_FILE_MANAGEMENT_JOB | 0x07))] HRESULT Notifications(
   [out, retval] SAFEARRAY(VARIANT)* notifications
 );

notifications: Pointer to a SAFEARRAY that upon completion contains all the notification period values for the file management job. A caller MUST release the SAFEARRAY received when the caller is done with it.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80070057

E_INVALIDARG

The notifications parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that notifications is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

 The server MUST create a SAFEARRAY object and populate it with all the notification periods for the file management job.