描述
IWbemConfigureRefresher.AddObjectByPath方法通过指定对象路径将对象添加到复习器。
C++ 语法
HRESULT AddObjectByPath( [in] IWbemServices *pNamespace, [in] LPCWSTR wszPath, [in] long lFlags, [in] IWbemContext *pCtx, [out] IWbemClassObject **ppRefreshable, [out] long *plId ); |
PowerBASIC 语法
METHOD AddObjectByPath ( _ BYVAL pNamespace AS IWbemServices, _ BYREF wszPath AS WSTRINGZ, _ 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.
wszPath
固定的，以null结尾的16位Unicode字符的字符串，其中包含您添加到复习器的对象的对象路径。
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_E_REFRESHER_BUSY |
复习者忙于另一个操作。 |
WBEM_S_NO_ERROR |
操作成功。 |
备注
提供的路径必须指定由高性能提供程序提供的有效对象。刷新操作正在进行时，客户端不得触摸返回的对象。Remove函数可以使用返回的标识符来删除该对象。
注意用户无需显式删除添加的对象。当不再需要返回的对象时，客户端必须调用发布.
要求
客户 |
需要Windows Vista，Windows XP，Windows 2000 Professional或Windows NT Workstation 4.0 SP4及更高版本。 |
服务器 |
需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
图书馆 |
使用Wbemuuid.lib。 |
DLL |
需要Wbemperf.dll。 |