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 函数可以使用返回的标识符来删除对象。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wbemcli.h (包括 Wbemidl.h) |
Library | Wbemuuid.lib |