IDataCollectorSet：：Start 方法 (pla.h)

手動啟動數據收集器集合。

語法

HRESULT Start(
  [in] VARIANT_BOOL Synchronous
);

[in] Synchronous

數據收集會在個別進程中執行。這個值會決定方法傳回的時機。

設定為 VARIANT_TRUE 在數據收集程序啟動或無法啟動之後傳回方法。傳回值表示集合已成功啟動或無法啟動。

設定為 VARIANT_FALSE，以在集合排入佇列執行之後傳回。傳回值表示集合是否已成功排入佇列。如需詳細資訊，請參閱＜備註＞。

如果成功，則傳回S_OK。下表顯示可能的錯誤值。

傳回碼	Description
E_INVALIDARG	集合必須保存 (開始收集之前，請參閱 Commit 方法) 。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)	系統找不到所指定的路徑。當 RootPath 屬性指定不存在的目錄時，就會發生此錯誤。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	子目錄或記錄檔已經存在。嘗試使用格式來唯一識別檔案。

若要判斷集合的狀態，請存取 IDataCollectorSet：：Status 屬性。

當收集程式完成時，如果已啟用，PLA 就會執行數據管理員。

若要依排程自動啟動數據收集，請參閱 IDataCollectorSet：：Schedules。

如果您以異步方式啟動設定，則會將事件寫入 Microsoft-Windows-Diagnosis-PLA/Operational 事件記錄檔，以指出收集程式是否已啟動 (事件 1003) 或失敗 (事件 1004) 。