描述
IWbemContext.Next方法在以IWbemContext.BeginEnumeration开头的所有上下文值的枚举中检索下一个值。
C++ 语法
HRESULT Next( [in] LONG lFlags, [out] BSTR *pstrName, [out] VARIANT *pValue ); |
PowerBASIC 语法
METHOD Next ( _ BYVAL lFlags AS LONG, _ BYREF pstrName AS WSTRING, _ BYREF pValue AS VARIANT _ ) AS LONG |
参数
lFlags
保留。该参数必须为0。
pstrName
空字符串的地址。如果没有返回错误代码，则将其设置为指向包含上下文值名称的新分配的BSTR.请注意，如果pstrName指向有效的BSTR条目，则此BSTR不会被释放，并且会发生内存泄漏。
pValue
此参数不能为NULL，它必须指向空或未初始化VARIANT.如果没有返回错误，VARIANT将使用VariantInit初始化，然后设置为包含上下文值。如果返回错误代码，则p值指向的VARIANT未修改。
如果WBEM_S_NO_MORE_DATA返回，则此参数设置为指向VT_NULL类型的VARIANT.
有可能在VARIANT内部返回整个IWbemClassObject对象。如果是这样，则VT_UNKNOWN是VARIANT类型。主叫方可以使用IUnknown指针并执行QueryInterface获得IWbemClassObject指针。
注意在枚举结束时，返回WBEM_S_NO_MORE_DATA。返回的VARIANT的类型为VT_NULL，返回的pstrName为NULL。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_UNEXPECTED |
来电者没有打电话IWbemContext.BeginEnumeration. |
WBEM_S_NO_ERROR |
通话成功。 |
WBEM_S_NO_MORE_DATA |
枚举中不再有其他属性。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成通话。 |
要求
客户 |
需要Windows Vista，Windows XP，Windows 2000 Professional，Windows NT Workstation 4.0 SP4及更高版本，Windows Me，Windows 98或Windows 95。 |
服务器 |
需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
DLL |
需要Esscli.dll。 需要Fastprox.dll。 需要Framedyn.dll。 需要Wbemcomn.dll。 需要Wbemcore.dll。 需要Wbemess.dll。 需要Wmipjobj.dll。 |