Share via

IWbemEventProviderQuerySink：：NewQuery 方法 (wbemprov.h)

  • 项目

当逻辑事件使用者向 Windows 管理注册相关事件查询筛选器时，调用 IWbemEventProviderQuerySink：：NewQuery 方法。 NewQuery 方法确定提供程序如何响应客户端应用程序注册的新查询。 当 WMI 从使用者接收新的或修改的事件查询时，WMI 会调用 NewQuery 以将查询回显到事件提供程序。 然后，提供程序生成请求的通知。

语法

HRESULT NewQuery(
  [in] unsigned long dwId,
  [in] WBEM_WSTR     wszQueryLanguage,
  [in] WBEM_WSTR     wszQuery
);

参数

[in] dwId

Windows 管理为查询生成的标识符。 提供程序可以跟踪此查询，以便在以后调用 CancelQuery 期间，以便提供程序知道哪个查询已取消。

[in] wszQueryLanguage

以下查询筛选器的语言。 对于此版本的 WMI，它将始终为“WQL”。

[in] wszQuery

由逻辑使用者注册的事件查询筛选器的文本。 事件提供程序可以通过 wszQuery 参数和 wszQueryLanguage 参数中查询筛选器的语言检查查询筛选器的文本，以发现使用者请求的事件通知。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 NewQuery 返回的返回代码。 此外，第三方事件提供程序可以返回任何有效的 WMI 或 COM 返回代码，这些代码可通过 NewQuery 作为返回值传递。

注解

如果使用者向 Windows 管理注册事件筛选器查询，并且查询包含对当前事件提供程序提供的事件的引用，则 Windows 管理可以通知事件提供程序查询。

如果提供程序实现 IWbemEventProviderQuerySink 接口，Windows Management 将向提供程序提供查询文本的副本。 提供程序应分析查询，并确定它是否可以执行任何内部优化。

Windows 管理不希望提供程序以任何方式更改其行为。 相反，这是一个咨询调用，以帮助提供程序进行内部优化。

例如，如果提供程序能够提供数百个事件，但提供所有这些事件所需的开销很大，那么，如果提供程序知道当前事件使用者集不需要其中大多数事件，则可以节省大量费用。 如果提供程序实现 IWbemEventProviderQuerySink，它将知道所有使用者请求的当前事件集。 在使用者实际开始请求此类事件之前，它可以避免设置用于传递它支持的大部分事件类型的机制。

对于每个新的使用者查询筛选器，将使用唯一的 dwId 单独调用此方法。 请注意，Windows 管理保留针对同一 dwId 值多次调用 NewQuery 的权利;例如，如果系统中的其他位置存在架构更改。 对于此版本的 WMI，查询语言始终为“WQL”。

可以在 IWbemEventProvider：:P rovideEvents 方法之前调用 IWbemEventErQuerySink：：NewQuery 方法。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemprov.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Wbemsvc.dll

另请参阅

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink：：CancelQuery