IDataCollectorSet：：Query 方法 (pla.h)

擷取指定的數據收集器集合。

語法

HRESULT Query(
  [in] BSTR name,
  [in] BSTR server
);

[in] name

要擷取之數據收集器集的名稱。名稱不區分大小寫，且格式為 [Namespace]Name。如需選擇性命名空間的詳細資訊，請參閱。

[in] server

集合所在的計算機。您可以指定電腦名稱、完整功能變數名稱或IP位址， (IPv4 或 IPv6 格式) 。如果 為 NULL，則會從本機電腦擷取集合。

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

傳回碼/值	Description
PLA_E_DCS_NOT_FOUND 0x80300002	找不到指定的數據收集器集合。
E_NOINTERFACE 0x80300002	您必須將數據收集器集合擷取到空白實例，或擷取至使用相同的命名空間的實例。
HRESULT_FROM_WIN32 (RPC_S_SERVER_UNAVAILABLE)	RPC 伺服器無法使用。方法無法從遠端查詢數據收集器集合。若要從執行 Windows Vista 的遠端電腦查詢資料收集器集合，請在遠端電腦上的 Windows 防火牆設定中啟用效能記錄和警示。
HRESULT_FROM_WIN32 (ERROR_BAD_NETPATH)	找不到遠端電腦。

所擷取數據收集器集合的內容會覆寫這個實例的內容。實例必須是空的， (新建立) 或來自相同的命名空間。

指定您在呼叫 IDataCollectorSet：：Commit 方法來儲存集合時所指定的相同名稱和伺服器參數值。

name 參數可以包含選擇性命名空間;不過，您應該一律指定命名空間。如果您未指定命名空間，PLA 會針對執行 Windows Vista 的電腦使用「服務」，並在 Windows Vista 之前執行作業系統的電腦使用「舊版」。下表列出可能的命名空間值。

命名空間	描述
自動設定	包含 ETW AutoLogger 工作階段。收集器會在電腦啟動時啟動，無法停止，且狀態為未定義。
舊版	與服務相同，但在執行 Windows Vista 之前作業系統的電腦上。
服務	包含使用者建立的所有數據收集器集合。這些集合可以排程，而且可以設定為在使用者需要批次登入帳戶) (執行。如果您未指定認證，如果使用者是系統管理員) ，則此集合會以 LocalSystem (的形式執行。
工作階段	包含 Windows (ETW 的事件追蹤) 追蹤工作階段。無法排程這些集合。如果您使用此命名空間，集合必須只包含一個數據收集器，而且必須是追蹤資料收集器。
系統	包含無法排程的唯讀數據收集器集合;不過，您可以手動啟動這些集合。如果您未指定認證，則集合會以目前使用者身分執行。

請注意，服務命名空間可以在 Windows Vista 之前執行作業系統的電腦上取代舊版命名空間。

若要查詢計算機上所有認可的集合，請呼叫 IDataCollectorSetCollection：：GetDataCollectorSets 方法。