IWbemConfigureRefresher::AddObjectByPath 方法 (wbemcli.h)

IWbemConfigureRefresher::AddObjectByPath 方法通过指定对象路径将对象添加到刷新器。

语法

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

参数

[in] pNamespace

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

[in] wszPath

包含添加到刷新程序的对象路径的 16 位 Unicode 字符的常量、以 null 结尾的字符串。

[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

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

性能计数器提供程序