3.2.4.2.34.14 EnumReports (Opnum 24)

  • Article

The EnumReports method enumerates all the reports configured for the report job and returns S_OK upon successful completion.

 [id(FSRM_DISPID_REPORT_JOB | 0x01)] HRESULT EnumReports(
   [out, retval] IFsrmCollection** reports
 );

reports: Pointer to an IFsrmCollection interface pointer (section 3.2.4.2.1) that upon completion contains pointers to the report objects configured for the report job. A caller MUST release the collection 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 reports parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that reports is not NULL.

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

The server MUST populate reports with the IFsrmReport interface pointer (section 3.2.4.2.35) of each report configured for the report job object.

If there are no reports configured for the report job (that is, the Report Job.Reports list is empty), the server MUST return an IFsrmCollection object that contains zero objects.