3.2.4.2.48.36 LastError (get) (Opnum 46)

The LastError (get) method retrieves the last error, if any, from when the file management job was previously run and returns S_OK upon successful completion. If no error occurred on the previous file management job run, the returned string will be empty and LastError (get) MUST return S_FALSE.

 [propget, id(FSRM_PROPERTY(FSRM_DISPID_FILE_MANAGEMENT_JOB | 0x14))] HRESULT LastError(
   [out, retval] BSTR* lastError
 );

lastError: Pointer to a variable that upon completion contains the last error, if any, from when the file management job was previously generated.

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

Return value/code

Description

0x80070057

E_INVALIDARG

The lastError parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that lastError is not NULL.

  • Set lastError to the Last error of the file management job object instance or return a nonzero error code.

  • If lastError is an empty string, the server MUST return S_FALSE, otherwise it MUST return S_OK.

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