大网数据广告活动
.NET 与 C# 开发

ExecQueryWmi 函数 (非托管 API 参考)

· 52CE 我爱测

此函数返回以下值中定义*WbemCli.h*标头文件,也可以在定义它们为常量在代码中:

执行查询以检索对象。

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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 11/06/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。