IWSManSession：：Enumerate 方法 (wsmandisp.h)

列舉數據表、數據收集或記錄資源。 若要建立查詢，請在列舉中包含 篩選 參數和 方言 參數。 您也可以使用 IWSManResourceLocator 物件來建立查詢。 如需詳細資訊，請參閱 列舉或列出資源的所有實例。

語法

HRESULT Enumerate(
  [in]           VARIANT   resourceUri,
  [in, optional] BSTR      filter,
  [in, optional] BSTR      dialect,
  [in]           long      flags,
  [out]          IDispatch **resultSet
);

參數

[in] resourceUri

要擷取之資源的標識碼。

下列清單包含此參數可包含的識別碼：

• 具有一或多個 選取器的 URI。 呼叫 Enumerate 方法以取得 WMI 資源時，請使用 物件的索引鍵屬性或屬性。
• 您可以使用 選取器、 片段或 選項。 如需詳細資訊，請參閱 IWSManResourceLocator。
• WS 位址 端點參考，如 WS-Management 通訊協定標準中所述。 如需有關 WS-Management 通訊協定之公用規格的詳細資訊，請參閱 管理規格索引頁面。

[in, optional] filter

定義列舉傳回資源中專案的篩選條件。 列舉資源時，只會傳回符合篩選準則的專案。 在列舉中包含 篩選 參數和 方言 參數，會將列舉轉換成查詢。

如果您有 resourceURI 參數的 IWSManResourceLocator 物件，則不應該使用此參數。 請改用 IWSManResourceLocator 的選取器和片段功能。

[in, optional] dialect

篩選所使用的語言。 WQL 是 WMI 所使用的 SQL 子集，是唯一支援的語言。

如果您有 resourceURI 參數的 IWSManResourceLocator 物件，則不應該使用此參數。 請改用 IWSManResourceLocator 的選取器和片段功能。

[in] flags

此參數必須包含 __WSManEnumFlags 列舉中的旗標。 如需詳細資訊，請參閱 列舉常數。

[out] resultSet

包含列舉結果的 IWSManEnumerator 物件。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

呼叫 IWSManSession：：Enumerate 以啟動列舉作業。 之後，使用傳回的 IWSManEnumerator 物件呼叫 IWSManEnumerator：：ReadItem，直到 AtEndOfStream 屬性指出項目結尾為止。

請注意，如果旗標包含 列舉常數WSManFlagHierarchyDeepBasePropsOnly 或 WSManFlagHierarchyShallow ，則 Windows 遠端管理服務會傳回錯誤碼 ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED。

如需在列舉期間限制網路呼叫的詳細資訊，請參閱 BatchItems 屬性。

如果指定篩選條件，它必須是與資源架構相關的有效檔。 方言參數是選擇性的。 不過，如果篩選字串以 <開頭，但不是 XML 片段，則請在 flags 參數中包含方言參數或設定 WSManFlagNonXmlText 旗標。 如需詳細資訊，請參閱 列舉常數。

對應的腳本方法是 Session.Enumerate。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wsmandisp.h
程式庫	WSManDisp.tlb
Dll	WSMAuto.dll

另請參閱

IWSManEnumerator

IWSManSession

Session.Enumerate