Método IWbemContext::Next (wbemcli.h)

  • Artículo

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 .

Nota Al final de la enumeración, se devuelve WBEM_S_NO_MORE_DATA . El valor VARIANT devuelto es de tipo VT_NULL y el valor de pstrName devuelto es NULL.
 

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

Consulte también

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::EndEnumeration