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 头文件中定义，也可以将它们定义为代码中的常数：
| 常数 | Value | 说明 |
|---|---|---|
WBEM_FLAG_USE_AMENDED_QUALIFIERS |
0x20000 | 如果设置为此值，则函数会检索修改后的限定符，这些限定符存储在当前连接区域设置的本地化命名空间中。 如果未设置为此值，则函数仅检索存储在直接命名空间中的限定符。 |
WBEM_FLAG_DEEP |
0 | 枚举包括此项和层次结构中的所有子类。 |
WBEM_FLAG_SHALLOW |
1 | 枚举仅包括此类的纯实例，并排除子类（提供的属性在此类中未找到）的所有实例。 |
WBEM_FLAG_RETURN_IMMEDIATELY |
0x10 | 此标志会导致半同步调用。 |
WBEM_FLAG_FORWARD_ONLY |
0x20 | 函数返回只进枚举器。 通常，相较于传统枚举器，只进枚举器更快并且使用的内存更少，但它们不允许调用克隆。 |
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 头文件中定义的，你也可以在代码中将这些值定义为常数：
| 常数 | Value | 说明 |
|---|---|---|
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 起可用
