3.2.4.2.34.7 Formats (put) (Opnum 17)

  • Article

The Formats (put) method sets the list of report formats that the report job will create when the report job is generated.

 [propput, id(FSRM_PROPERTY (FSRM_DISPID_REPORT_JOB | 0x03))] HRESULT Formats(
   [in] SAFEARRAY (VARIANT) formats
 );

formats: Contains the array of report formats that will be created when the report job is 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 formats parameter is not a valid value. If one of the formats is FsrmReportFormat_Unknown, the parameter MUST be considered invalid.

Upon receiving this message, the server MUST validate parameters:

  • Verify that formats contains valid FsrmReportFormat (section 2.2.1.2.14) values. If any one of the formats is FsrmReportFormat_Unknown, the parameter MUST be considered an invalid value.

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

The server MUST set the Report Job.Formats list on the report job object.