Compartir a través de

Función Next

  • Artículo

Esta función puede usarse para recuperar la siguiente propiedad de una enumeración que comience con una llamada a la función BeginEnumeration.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parámetros

vFunc
[in] Este parámetro no se usa.

ptr
[in] Puntero a una instancia de IWbemClassObject.

lFlags
[in] Reservado. El valor de este parámetro deberá ser 0.

pstrName
[out] El valor de este parámetro se corresponde con una nueva cadena BSTR donde se incluye el nombre de la propiedad. Si el nombre no es necesario, puede establecer este parámetro en null.

pVal
[out] El valor de este parámetro se corresponde con un objeto VARIANT que se rellena con el valor de la propiedad. Si el valor no es necesario, puede establecer este parámetro en null. Si la función devuelve un código de error, el objeto VARIANT que se pase al parámetro pVal no se modificará.

pvtType
[out] El valor de este parámetro se corresponde con un puntero que apunta a una variable CIMTYPE (un elemento LONG en el que se especifica el tipo de la propiedad). El valor de esta propiedad puede corresponderse con un elemento VT_NULL_VARIANT. Si es así, será necesario determinar el tipo real de la propiedad. Este parámetro también puede establecerse en null.

plFlavor
[out] El valor de este parámetro puede ser null o un valor en el que se recibe información sobre el origen de la propiedad. Vaya a la sección [Comentarios] para consultar los valores que pueden devolverse.

Valor devuelto

Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:

Constante Value Descripción
WBEM_E_FAILED 0x80041001 Si se devuelve este valor, significará que se ha producido un error general.
WBEM_E_INVALID_PARAMETER 0x80041008 Si se devuelve este valor, significará que el parámetro en cuestión no es válido.
WBEM_E_UNEXPECTED 0x8004101d Si se devuelve este valor, significará que no se produjo ninguna llamada a la función BeginEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Si se devuelve este valor, significará que no hay suficiente memoria disponible para comenzar una nueva enumeración.
WBEM_E_TRANSPORT_FAILURE 0x80041015 Si se devuelve este valor, significará que ha ocurrido un error en la llamada a procedimiento remoto que iba a establecerse entre el proceso actual y Administración de Windows.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.
WBEM_S_NO_MORE_DATA 0x40005 No hay más propiedades en la enumeración.

Comentarios

Al usar esta función, se ajusta una llamada al método IWbemClassObject::Next.

En este método también se devuelven las propiedades del sistema.

Si el tipo subyacente de la propiedad es una ruta de acceso de objeto, una fecha u hora u otro tipo especial, el tipo de valor devuelto no contendrá suficiente información. El llamador deberá examinar la propiedad que se especifique en el elemento CIMTYPE para determinar si esta es una referencia de objeto, una fecha u hora u otro tipo especial.

Si el valor del parámetro plFlavor no es null, el valor LONG se corresponderá con información sobre el origen de la propiedad, como se indica a continuación:

Constante Value Descripción
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 La propiedad es una propiedad del sistema estándar.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 Para una clase: la propiedad se hereda de la clase primaria.
Para una instancia: la instancia no ha modificado la propiedad, que se hereda de la clase primaria.
WBEM_FLAVOR_ORIGIN_LOCAL 0 Para una clase: la propiedad pertenece a la clase derivada.
Para una instancia: si se devuelve este valor, significa que la instancia ha modificado la propiedad; es decir, se le proporcionó un valor o se agregó o modificó un calificador.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también