描述
IWbemHiPerfEnum.GetObjects方法检索当前驻留在枚举器中的对象。
C++ 语法
HRESULT GetObjects( [in] long lFlags, [in] ULONG uNumObjects, [out] IWbemObjectAccess *apObj, [out] ULONG *puReturned ); |
PowerBASIC 语法
METHOD GetObjects ( _ BYVAL lFlags AS LONG, _ BYVAL uNumObjects AS DWORD, _ BYREF apObj AS IWbemObjectAccess, _ BYREF puReturned AS DWORD _ ) AS LONG |
参数
lFlags
包含标志的整数。
uNumObjects
在apObjbs参数中传递给此方法的数组的大小。
apObj
指针包含对IWbemObjectAccess对象的数组的引用，它包含返回的对象。该数组必须足够大以容纳枚举器中的所有对象。
puReturned
指向ULONG的指针用于返回放置在数组中的对象数。
返回值
此方法返回一个HRESULT，表示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_S_NO_ERROR |
该方法成功。 |
WBEM_E_BUFFER_TOO_SMALL |
提供的缓冲区太小，无法容纳枚举器中的所有对象。 |
WBEM_S_TIMEDOUT |
调查员忙于另一个操作。 |
WBEM_E_NOT_FOUND |
提供程序无法检索请求的实例。 |
WBEM_E_PROVIDER_NOT_CAPABLE |
提供程序无法检索特定实例，而不管提供程序是否识别路径。
除非您需要特定的错误代码，否则应在所有情况下返回此错误代码。 |
WBEM_E_FAILED |
提供者在内部失败，但操作有效。 |
备注
该数组必须足够大以容纳所有对象，否则puReturned填充返回对象的数量，并返回WBEM_E_BUFFER_TOO_SMALL。
要求
客户 |
需要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中声明。 |
DLL |
需要Wbemperf.dll。 |