停止

在文件日志记录模式下停止记录。

语法

HRESULT Stop
  ([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_STOP_PROFILE

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

E_WPRC_TRACE_MERGE_LOST_EVENTS

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

注解

仅将此函数用于按顺序记录到文件中的配置文件。 在保存会话后,记录将停止。

IControlManager