保存

  • 项目

将记录到内存中循环缓冲区的录制内容保存到指定的事件跟踪日志 (ETL) 文件。 记录将继续运行。

语法

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

参数

bstrFileName
[in] 将来自所有配置文件记录的合并事件保存到的文件的名称。

pProfileCollection
[in] 指向包含要保存的配置文件集合的 IProfileCollection 对象的指针。

pTraceMergeProperties
[in] 指向包含用于合并记录的属性的 ITraceMergeProperties 对象的指针。

返回值

下表描述了可能的返回值。

返回值 说明

S_OK

该函数已成功保存记录。

E_INVALIDARG

一个或多个参数无效。

E_WPRC_FAILED_TO_SAVE_PROFILE

库未能在配置文件集合中保存配置文件。 使用 IControlErrorInfo 获取详细的错误信息。

E_WPRC_TRACE_MERGE_LOST_EVENTS

Windows 事件跟踪 (ETW) 会话丢失了事件，从会话合并事件跟踪日志 (ETL) 文件可能会创建不完整的 ETL 文件。

注解

此函数仅用于记录到循环缓冲区的配置文件。 在保存会话后，记录将继续运行。

IControlManager