IWbemConfigureRefresher::AddObjectByTemplate 方法 (wbemcli.h)
使用 IWbemConfigureRefresher::AddObjectByTemplate 方法,可以通过指定 IWbemClassObject 实例模板将想要刷新的对象添加到刷新器。 如果很难为要添加到刷新程序的对象构造对象路径,请使用此方法。
语法
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 |