Share via

3.18.4.5 ExportClusterPerformanceHistory (Opnum 7)

  • Article

The ExportClusterPerformanceHistroy method<50> generates the health log file on cluster nodes. The content and format of the file is implementation-specific but SHOULD contain diagnostic information.

 HRESULT ExportClusterPerformanceHistory {
   [ in ] BSTR Pattern,
   [ in ] BSTR StreamName,
   [ in ] ClusterLogExFlag flags,
   [ out ] BSTR* LogFilePath
 };

Pattern: This parameter MUST be ignored.

StreamName: The name of the performance history stream to be exported.

Flags: Is the type ClusterLogExFlag enum as specified in section 2.2.25.

LogFilePath: Has the same meaning as parameter LogFilePath for the GenerateClusterLog method specified in section 3.12.4.1.

Return Values: Return values are the same as the return values for the GenerateClusterLog method specified in section 3.12.4.1.

Return value/code

Description

0x00000000

S_OK

The call was successful.

For any other condition, this method MUST return a value that is not one of the values listed in the preceding table. The client MUST behave in an identical manner for all return values not listed in the preceding table.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

The opnum field value for this method is 7.

When processing this call, the server MUST do the following:

  • If ClusterLogFlagLocalTime is set in the Flags field, use local time on the server.

  • Generate the performance history log file from the correct stream.

  • Place the file in a valid LogFilePath on the machine, as specified in section 3.18.4.1.

  • Generate the server-relative path to the file.

Return the following information to the client:

  • The server-relative path to the file.