执行查询以检索对象。
Note: 此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT ExecQueryWmi (
[in] BSTR strQueryLanguage,
[in] BSTR strQuery,
[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
);
参数
strQueryLanguage
[in]具有支持的 Windows 管理的有效的查询语言的字符串。 它必须是"WQL",WMI 查询语言的缩写词。
strQuery
[in]查询的文本。 此参数不能为 null。
lFlags
[in]影响此函数的行为的标志的组合。 以下值中定义WbemCli.h标头文件,也可以在定义它们为常量在代码中:
| 返回的常量 | 值 | 描述 |
|---|---|---|
WBEM_FLAG_USE_AMENDED_QUALIFIERS |
0x20000 | 如果集,该函数检索当前连接的区域设置的本地化命名空间中存储已修正的限定符。 如果未设置,此函数检索仅立即命名空间中存储的限定符。 |
WBEM_FLAG_RETURN_IMMEDIATELY |
0x10 | 该标志会导致半同步调用。 |
WBEM_FLAG_FORWARD_ONLY |
0x20 | 该函数返回的只进的枚举器。 通常情况下,只进的枚举器速度更快,并使用较少的内存比传统的枚举器,但它们不允许对调用克隆。 |
WBEM_FLAG_BIDIRECTIONAL |
0 | WMI 将保留指向对象的枚举中的指针,直到它们被释放。 |
WBEM_FLAG_ENSURE_LOCATABLE |
0x100 | 可确保任何返回的对象中都有足够的信息,因此该系统属性,如 __PATH, __RELPATH,并 __SERVER,不是null。 |
WBEM_FLAG_PROTOTYPE |
2 | 此标志用于原型制作。 它不会执行查询,并改为返回类似于典型的结果对象的对象。 |
WBEM_FLAG_DIRECT_READ |
0x200 | 原因直接访问该提供程序不考虑其父类或任意子类的情况下指定的类。 |
建议的标志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_PARAMETER |
0x80041008 | 参数不是有效的。 |
WBEM_E_INVALID_QUERY |
0x80041017 | 查询发生了语法错误。 |
WBEM_E_INVALID_QUERY_TYPE |
0x80041018 | 不支持请求的查询语言。 |
WBEM_E_QUOTA_VIOLATION |
0x8004106c | 查询太过复杂。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 没有足够的内存是可用于完成该操作。 |
WBEM_E_SHUTTING_DOWN |
0x80041033 | WMI 是可能已停止并重新启动。 调用ConnectServerWmi试。 |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | 之间的当前进程和 WMI 的远程过程调用 (RPC) 链接已失败。 |
WBEM_E_NOT_FOUND |
0x80041002 | 该查询指定不存在的类。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
备注
此函数包装对的调用IWbemServices::ExecQuery方法。
此函数将处理中指定的查询strQuery参数,并创建通过其调用方可以访问查询结果的枚举器。 枚举器是一个指向IEnumWbemClassObject接口; 查询结果是通过提供的类对象的实例IWbemClassObject接口。
有数限制AND和OR可以在 WQL 查询中使用的关键字。 大量的复杂查询中使用的 WQL 关键字可能会导致 WMI 返回WBEM_E_QUOTA_VIOLATION(或 0x8004106c) 错误代码为HRESULT值。 WQL 关键字的限制取决于复杂的查询是。
如果函数调用失败,则可以通过调用获取其他错误信息GetErrorInfo函数。
要求
平台: 请参阅系统需求。
标头: WMINet_Utils.idl
**.NET Framework 版本:**自 4.7.2 之后可用
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
