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 |