停止
在文件日志记录模式下停止记录。
语法
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 文件。 |
注解
仅将此函数用于按顺序记录到文件中的配置文件。 在保存会话后,记录将停止。