IWbemConfigureRefresher：：AddObjectByTemplate 方法 (wbemcli.h)

  • 项目

使用 IWbemConfigureRefresher：：AddObjectByTemplate 方法，可以通过指定 IWbemClassObject 实例模板将想要刷新的对象添加到刷新器。 如果很难为要添加到刷新程序的对象构造对象路径，请使用此方法。

注意 必须先填写实例对象的关键属性，然后才能调用 AddObjectByTemplate 方法。
 

语法

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

参数

pNamespace

返回 Windows 管理的 IWbemServices 指针，它可以为提供程序发出的任何请求提供服务。 如果提供程序在执行期间要回调到 Windows 管理，则此指针上应调用 AddRef 。

[in] pTemplate

指向包含实例模板的 IWbemClassObject 对象的指针。

[in] lFlags

修改此方法行为的标志的位掩码。 如果此参数设置为 WBEM_FLAG_USE_AMENDED_QUALIFIERS，则返回的实例将包含本地化的限定符（如果可用）。

[in] pContext

通常 为 NULL;否则为指向一个或多个动态类提供程序所需的 IWbemContext 对象的指针。 上下文对象中的值必须在特定的提供程序文档中指定。 有关此参数的详细信息，请参阅 调用 WMI。

[out] ppRefreshable

用于保存对 IWbemClassObject 对象的引用的指针，该对象将包含可刷新实例对象。 当不再需要时，客户端必须对返回的对象调用 Release 。

[out] plId

指向提供程序返回的整数的指针，该整数唯一标识此可刷新对象。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。

注解

提供的实例必须指定有效的 对象，该对象由 High-Performance 提供程序提供。 正在执行刷新操作时，客户端不得修改返回的对象。 Remove 函数可以使用返回的标识符来删除对象。

用户无需显式删除添加的对象。 当不再需要时，客户端必须对返回的对象调用 Release 。

要求

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

另请参阅

在 C++ 中访问性能数据

IWbemConfigureRefresher

将实例提供程序转换为高性能提供程序

性能计数器提供程序