共用方式為


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

要擷取之資源的標識碼。

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

[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 屬性指出項目結尾為止。

請注意,如果旗標包含 列舉常數WSManFlagHierarchyDeepBasePropsOnlyWSManFlagHierarchyShallow ,則 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