儲存
將記錄到記憶體中迴圈緩衝區的錄製,儲存至指定的事件追蹤記錄檔 (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 檔案。 |
備註
此函式僅用於記錄至迴圈緩衝區的設定檔。 儲存會話之後,錄製會繼續執行。