3.2.4.2.24 Run (Opnum 30)

The Run method is used to manually run the data manager. When the data manager is run, the actions specified in the Steps parameter are executed on the data stored in the folder specified by the bstrFolder. Actions taken can include creating an XML report from binary performance files (.blg) or event trace files (.etl), running XPath expressions against the report, transforming the report to HTML, cabbing the report and sending it to a remote server, and deleting files in the directory specified by bstrFolder.

 HRESULT Run(
   [in] DataManagerSteps Steps,
   [in] BSTR bstrFolder,
   [out, retval] IValueMap** Errors
 );

Steps: Supplies the actions to be performed by the data manager. For more information, see section 2.2.2.6.

bstrFolder: Supplies the name of the subfolder where the report will be generated, rules applied, and/or HTML created.

Errors: Receives a validation value map, stored as an IValueMap, containing a list of subfolders on which the data manager did not successfully run; each subfolder is represented as an IValueMapItem. The Names property of the IValueMapItem represents the path to a subfolder, while the Values property of the IValueMapItem represents the HRESULT describing the specific problem with that subfolder. The ValueMapType of the IValueMap is plaValidation; more information can be found in section 2.2.11.

Return Values: This method MUST return an HRESULT with the severity bit clear on success as specified in [MS-ERREF]; otherwise, it MUST return one of the errors as defined in 2.2.1 or one of the errors as defined in [MS-ERREF] section 2.1.