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

ExecNotificationQueryWmi 函数 (非托管 API 参考)

· 52CE 我爱测

执行查询以接收事件。 调用立即返回,并且调用方可以轮询返回的枚举器的事件到达。 释放返回的枚举器取消查询。

执行查询以接收事件。 调用立即返回,并且调用方可以轮询返回的枚举器的事件到达。 释放返回的枚举器取消查询。

Note: 此 API 仅供内部使用。 不应从开发人员代码中使用。

语法

HRESULT ExecNotificationQueryWmi (
   [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_RETURN_IMMEDIATELY 0x10 该标志会导致半同步调用。 如果未设置此标志,则调用失败。 这是因为事件接收连续,这意味着用户必须轮询返回的枚举器。 无限期地阻止此调用,将无法进行。
WBEM_FLAG_FORWARD_ONLY 0x20 该函数返回的只进的枚举器。 通常情况下,只进的枚举器速度更快,并使用较少的内存比传统的枚举器,但它们不允许对调用克隆。

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_CLASS 0x80041010 该查询指定不存在的类。
WBEMESS_E_REGISTRATION_TOO_PRECISE 0x80042002 已请求中传递的事件过多精度。 必须指定更大的轮询容差。
WBEMESS_E_REGISTRATION_TOO_BROAD 0x80042001 查询请求比提供 Windows 管理的详细信息。 这HRESULT事件查询导致轮询一个命名空间中的所有对象的请求时返回。
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_UNPARSABLE_QUERY 0x80041058 无法分析查询。
WBEM_S_NO_ERROR 0 函数调用成功。

备注

此函数包装对的调用IWbemServices::ExecNotificationQuery方法。

该函数返回后,调用方定期传递返回ppEnum对象传递给下一步函数以了解是否有任何事件。

有数限制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(示例代码)

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

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