描述
使用IWbemConfigureRefresher.AddObjectByTemplate方法，可以通过指定IWbemClassObject实例模板将要刷新的对象添加到复习。当难以构建要添加到复习器的对象的对象路径时，请使用此方法。
注意必须先填写实例对象的关键属性，然后才能调用AddObjectByTemplate方法。
C++ 语法
HRESULT AddObjectByTemplate( [in] IWbemServices *pNamespace, [in] IWbemClassObject *pTemplate, [in] long lFlags, [in] IWbemContext *pCtx, [out] IWbemClassObject **ppRefreshable, [out] long *plid ); |
PowerBASIC 语法
METHOD AddObjectByTemplate ( _ BYVAL pNamespace AS IWbemServices, _ BYVAL pTemplate AS IWbemClassObject, _ BYVAL lFlags AS LONG, _ BYVAL pCtx AS IWbemContext, _ BYREF ppRefreshable AS IWbemClassObject, _ BYREF plId AS LONG _ ) AS LONG |
参数
pNamespace
指向Windows Management的IWbemServices指针，可以为提供商提供的任何请求提供服务。如果在执行过程中要调用Windows Management，则该提供程序应调用该指针的AddRef.
pTemplate
指向包含实例模板的IWbemClassObject对象。
lFlags
修改此方法行为的标志位掩码。如果此参数设置为WBEM_FLAG_USE_AMENDED_QUALIFIERS，则返回的实例包含本地限定符（如果可用）。
pCtx
通常为NULL;否则，指向一个或多个动态类提供者所需的IWbemContext对象的指针。必须在特定提供者文档中指定上下文对象中的值。有关此参数的更多信息，请参阅拨打电话给WMI.
ppRefreshable
指针保存对IWbemClassObject对象的引用，该对象包含可刷新的实例对象。当不再需要时，客户端必须在返回的对象上调用发布.
plId
指向由提供程序返回的唯一标识可刷新枚举的整数的指针。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
参数无效。 |
WBEM_E_NOT_FOUND |
找不到请求的实例。 |
WBEM_E_ACCESS_DENIED |
当前用户没有执行此操作的权限。 |
WBEM_E_INVALID_OPERATION |
请求的实例不是由高性能提供商提供的。 |
WBEM_S_NO_ERROR |
操作成功。 |
WBEM_E_REFRESHER_BUSY |
复习者忙于另一个操作。 |
备注
提供的实例必须指定一个有效的对象，由高性能提供程序提供。刷新操作正在进行时，客户端不得修改返回的对象。返回的标识符可以由去掉函数用于删除对象。
用户无需显式删除添加的对象。当不再需要时，客户端必须在返回的对象上调用发布.
要求
客户 |
需要Windows Vista，Windows XP或Windows 2000 Professional。 |
服务器 |
需要Windows Server 2008，Windows Server 2003或Windows 2000 Server。 |
头 |
在Wbemcli.inc中声明。 |
图书馆 |
使用Wbemuuid.lib。 |
DLL |
需要Wbemperf.dll。 |