Compartir a través de

Función BeginEnumeration

  • Artículo

Esta función puede usarse para restablecer el enumerador a la posición de inicio de la enumeración.

Nota

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

Sintaxis

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parámetros

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

ptr
[in] El valor de este parámetro se corresponde con un puntero que apunta a una instancia de la interfaz IWbemClassObject.

lEnumFlags
[in] El valor de este parámetro de entrada se corresponde con una combinación bit a bit de las marcas o valores que se describen en la sección Comentarios. Esta combinación controla las propiedades que se incluyen en la enumeración.

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_INVALID_PARAMETER 0x80041008 Si se devuelve este valor, significará que la combinación de marcas del parámetro lEnumFlags no es válida o se especificó un argumento no válido.
WBEM_E_UNEXPECTED 0x8004101d Si se devuelve este valor, significará que se realizó una segunda llamada a la función BeginEnumeration sin que se realizase una llamada de intervención a la función EndEnumeration.
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_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.

Comentarios

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

Las marcas que se pueden pasar en el argumento lEnumFlags se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlas como constantes en el código. Puede combinar una marca de cada grupo con cualquier marca de cualquier otro grupo. Sin embargo, no es posible combinar marcas que pertenezcan a un mismo grupo.

Grupo 1

Constante Value Descripción
WBEM_FLAG_KEYS_ONLY 0x4 Si se usa esta marca, solo se incluirán las propiedades que constituyan la clave.
WBEM_FLAG_REFS_ONLY 0x8 Si se usa esta marca, solo se incluirán las propiedades que constituyan referencias a objetos.

Grupo 2

Constante Value Descripción
WBEM_FLAG_SYSTEM_ONLY 0x30 Si se usa esta marca, la enumeración se limitará a las propiedades del sistema.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Si se usa esta marca, las propiedades locales y propagadas se incluirán en la enumeración, pero se excluirán las propiedades del sistema.

Para clases:

Constante Value Descripción
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Si se usa esta marca, la enumeración se limitará a las propiedades invalidadas de la definición de clase.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Si se usa esta marca, la enumeración se limitará a las propiedades invalidadas de la definición de clase actual y a las nuevas propiedades que se definan en la clase.
WBEM_MASK_CLASS_CONDITION 0x300 En este caso, se aplicará una máscara (en lugar de una marca) sobre un valor del parámetro lEnumFlags para comprobar si se ha establecido la marca WBEM_FLAG_CLASS_OVERRIDES_ONLY o la marca WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES.
WBEM_FLAG_LOCAL_ONLY 0x10 Si se usa esta marca, la enumeración se limitará a las propiedades que se definan o modifiquen en la propia clase.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Si se usa esta marca, la enumeración se limitará a las propiedades que se hereden de las clases base.

Para instancias:

Constante Value Descripción
WBEM_FLAG_LOCAL_ONLY 0x10 Si se usa esta marca, la enumeración se limitará a las propiedades que se definan o modifiquen en la propia clase.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Si se usa esta marca, la enumeración se limitará a las propiedades que se hereden de las clases base.

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