CreateInstanceEnumWmi 函式
傳回會傳回滿足指定選取條件之指定類別執行個體的列舉程式。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT CreateInstanceEnumWmi (
[in] BSTR strFilter,
[in] long lFlags,
[in] IWbemContext* pCtx,
[out] IEnumWbemClassObject** ppEnum,
[in] DWORD authLevel,
[in] DWORD impLevel,
[in] IWbemServices* pCurrentNamespace,
[in] BSTR strUser,
[in] BSTR strPassword,
[in] BSTR strAuthority
);
參數
strFilter
[in] 需要實例的類別名稱。 這個參數不可以是 null。
lFlags
[in] 影響此函式行為的旗標組合。 下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_FLAG_USE_AMENDED_QUALIFIERS |
0x20000 | 如果設定，函式會擷取儲存在目前連接地區設定當地語系化命名空間中的修改限定詞。 如果未設定，函式只會擷取儲存在立即命名空間中的限定詞。 |
WBEM_FLAG_DEEP |
0 | 列舉包含階層中的這個和所有子類別。 |
WBEM_FLAG_SHALLOW |
1 | 列舉只包含這個類別的純實例，並排除提供這個類別中找不到屬性的所有子類別實例。 |
WBEM_FLAG_RETURN_IMMEDIATELY |
0x10 | 旗標會造成半同步呼叫。 |
WBEM_FLAG_FORWARD_ONLY |
0x20 | 函式會傳回順向列舉值。 一般而言，順向列舉值的速度較快，且使用記憶體比傳統列舉值少，但不允許呼叫 Clone。 |
WBEM_FLAG_BIDIRECTIONAL |
0 | WMI 會保留列舉中物件的指標，直到釋放為止。 |
建議的旗標為 WBEM_FLAG_RETURN_IMMEDIATELY 和 WBEM_FLAG_FORWARD_ONLY，以獲得最佳效能。
pCtx
[in] 一般而言，此值為 null。 否則會是指向 IWbemCoNtext 執行個體的指標，可供提供所要求類別的提供者使用。
ppEnum
[out] 接收列舉值的指標。
authLevel
[in] 授權等級。
impLevel
[in] 模擬等級。
pCurrentNamespace
[in] 代表目前命名空間的 IWbemServices 物件指標。
strUser
[in] 使用者名稱。 如需詳細資訊，請參閱 ConnectServerWmi 函式。
strPassword
[in] 密碼。 如需詳細資訊，請參閱 ConnectServerWmi 函式。
strAuthority
[in] 使用者的網域名稱。 如需詳細資訊，請參閱 ConnectServerWmi 函式。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_ACCESS_DENIED |
0x80041003 | 使用者沒有檢視指定類別實例的權限。 |
WBEM_E_FAILED |
0x80041001 | 發生未指定的錯誤。 |
WBEM_E_INVALID_CLASS |
0x80041010 | strFilter 不存在。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 參數無效。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足，無法完成作業。 |
WBEM_E_SHUTTING_DOWN |
0x80041033 | WMI 可能已停止並重新啟動。 再次呼叫 ConnectServerWmi。 |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | 目前處理序與 WMI 之間的遠端程序呼叫 (RPC) 連結失敗。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝 對 IWbemServices::CreateClassEnum 方法的呼叫。
請注意，傳回的列舉值可以有零個元素。
如果函式呼叫失敗，您可以藉由呼叫 GetErrorInfo 函式來取得其他錯誤資訊。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起可用
