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

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

性能计数器提供程序