Método IWbemContext::Next (wbemcli.h)
El método IWbemContext::Next recupera el siguiente valor en una enumeración de todos los valores de contexto que comienzan por IWbemContext::BeginEnumeration.
Sintaxis
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pValue
);
Parámetros
[in] lFlags
Reservado. El valor de este parámetro deberá ser 0.
[out] pstrName
Este parámetro no puede ser NULL. El puntero no debe apuntar a un BSTR activo en la entrada y, idealmente, debe establecerse para que apunte a NULL. Si no se devuelve ningún código de error, se establece para que apunte a un BSTR recién asignado que contenga el nombre del valor de contexto.
El autor de la llamada debe llamar a SysFreeString en la cadena devuelta cuando ya no sea necesario. Si WBEM_S_NO_MORE_DATA devuelve, pstrName se establece para que apunte a NULL, en cuyo caso no se debe llamar a SysFreeString . Tenga en cuenta que si pstrName apunta a un BSTR válido en la entrada, este BSTR no se libera y se produce una fuga de memoria.
[out] pValue
Este parámetro no puede ser NULL y debe apuntar a un VARIANT vacío o sin inicializar. Si no se devuelve ningún error, variant se inicializa mediante VariantInit y, a continuación, se establece para que contenga el valor de contexto. El autor de la llamada debe llamar a VariantClear en este puntero cuando el valor ya no es necesario. Si se devuelve un código de error, la VARIANTE a la que apunta pValue se deja sin modificar.
Si WBEM_S_NO_MORE_DATA devuelve, este parámetro se establece para que apunte a un VALOR VARIANT de tipo VT_NULL.
Es posible que se devuelva un objeto IWbemClassObject completo dentro de variant. Si es así, VT_UNKNOWN es el tipo VARIANT . El llamador puede tomar el puntero IUnknown y ejecutar QueryInterface para obtener el puntero IWbemClassObject .
Valor devuelto
Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | wbemcli.h (include Wbemidl.h) |
| Library | Wbemuuid.lib |
| Archivo DLL | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |