Save

  • Article

Saves a recording that is logged to circular buffers in memory to the specified event trace log (ETL) file. The recording continues to run.

Syntax

HRESULT Save
  ([in] BSTR bstrFileName,
  [in] IProfileCollection* pProfileCollection,
  [in] ITraceMergeProperties* pTraceMergeProperties)
;

Parameters

bstrFileName
[in] The name of the file to which merged events from recordings of all the profiles are saved.

pProfileCollection
[in] A pointer to the IProfileCollection object that contains a collection of profiles to save.

pTraceMergeProperties
[in] A pointer to the ITraceMergeProperties object that contains properties with which to merge recordings.

Return Value

The following table describes possible return values.

Return Value Description

S_OK

The function successfully saved the recording.

E_INVALIDARG

One or more arguments are invalid.

E_WPRC_FAILED_TO_SAVE_PROFILE

The library failed to save a profile in the profile collection. Use IControlErrorInfo to obtain detailed error information.

E_WPRC_TRACE_MERGE_LOST_EVENTS

The Event Tracing for Windows (ETW) session lost events, and merging the event trace log (ETL) files from the session may create an incomplete ETL file.

Remarks

This function is used only for profiles that are logging to circular buffers. After the sessions are saved, the recording continues to run.

IControlManager