共用方式為

BeginEnumeration 函式

  • 發行項

將列舉程式重設為列舉的開頭。

注意

此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。

語法

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

參數

vFunc
[in] 此參數未使用。

ptr
[in] IWbemClassObject 執行個體的指標。

lEnumFlags
[in] 備註一節中所述之旗標或值的位元組合，可控制列舉中包含的屬性。

傳回值

此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：

常數 值 描述
WBEM_E_INVALID_PARAMETER 0x80041008 lEnumFlags 中的旗標組合無效，或指定了不正確引數。
WBEM_E_UNEXPECTED 0x8004101d 在沒有介入呼叫 EndEnumeration 下進行第二次呼叫 BeginEnumeration。
WBEM_E_OUT_OF_MEMORY 0x80041006 記憶體不足，無法開始新列舉。
WBEM_S_NO_ERROR 0 函式呼叫成功。

備註

此函式會包裝對 IWbemClassObject::BeginEnumeration 方法的呼叫。

可以當做 lEnumFlags 引數傳遞的旗標，會於 WbemCli.h 標頭檔中定義，或者可以將它們定義為程式碼中的常數。 可以將每個群組中的一個旗標與任何其他群組中的任何旗標結合。 不過，來自相同群組的旗標會相互排斥。

群組 1

常數 值 描述
WBEM_FLAG_KEYS_ONLY 0x4 包含只構成索引碼的屬性。
WBEM_FLAG_REFS_ONLY 0x8 包含僅物件參考的屬性。

群組 2

常數 值 描述
WBEM_FLAG_SYSTEM_ONLY 0x30 將列舉限制為僅系統屬性。
WBEM_FLAG_NONSYSTEM_ONLY 0x40 列舉中包含本機和傳播的屬性，但排除系統屬性。

針對類別：

常數 值 描述
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 將列舉限制在類別定義中覆寫的屬性。
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 將列舉限制在目前類別定義中覆寫的屬性，以及類別中定義的新屬性。
WBEM_MASK_CLASS_CONDITION 0x300 將遮罩 (而非旗標) 套用至 lEnumFlags 值，以檢查 WBEM_FLAG_CLASS_OVERRIDES_ONLY 或 WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 是否已設定。
WBEM_FLAG_LOCAL_ONLY 0x10 將列舉限制在類別本身中定義或修改的屬性。
WBEM_FLAG_PROPAGATED_ONLY 0x20 將列舉限制為繼承自基底類別的屬性。

例如：

常數 值 描述
WBEM_FLAG_LOCAL_ONLY 0x10 將列舉限制在類別本身中定義或修改的屬性。
WBEM_FLAG_PROPAGATED_ONLY 0x20 將列舉限制為繼承自基底類別的屬性。

規格需求

平台：請參閱系統需求。

標頭：WMINet_Utils.idl

.NET Framework版本：自 4.7.2 起提供

另請參閱