Partilhar via

Função BeginEnumeration

  • Artigo

Repõe um enumerador novamente para o início da enumeração.

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

Sintaxe

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

Parâmetros

vFunc
[in] Este parâmetro não é utilizado.

ptr
[in] Um ponteiro para uma instância IWbemClassObject .

lEnumFlags
[in] Uma combinação bit-a-bit dos sinalizadores ou valores descritos na secção Observações que controla as propriedades incluídas na enumeração.

Valor devolvido

Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:

Constante Valor Descrição
WBEM_E_INVALID_PARAMETER 0x80041008 A combinação de sinalizadores no lEnumFlags é inválida ou foi especificado um argumento inválido.
WBEM_E_UNEXPECTED 0x8004101d Uma segunda chamada para BeginEnumeration foi feita sem uma chamada interveniente para EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Não existe memória suficiente disponível para iniciar uma nova enumeração.
WBEM_S_NO_ERROR 0 A chamada de função foi efetuada com êxito.

Observações

Esta função encapsula uma chamada para o método IWbemClassObject::BeginEnumeration .

Os sinalizadores que podem ser transmitidos à medida que o lEnumFlags argumento são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código. Pode combinar um sinalizador de cada grupo com qualquer sinalizador de qualquer outro grupo. No entanto, os sinalizadores do mesmo grupo são mutuamente exclusivos.

Grupo 1

Constante Valor Descrição
WBEM_FLAG_KEYS_ONLY 0x4 Inclua propriedades que constituem apenas a chave.
WBEM_FLAG_REFS_ONLY 0x8 Inclua propriedades que são apenas referências de objetos.

Grupo 2

Constante Valor Descrição
WBEM_FLAG_SYSTEM_ONLY 0x30 Limitar a enumeração apenas às propriedades do sistema.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Inclua propriedades locais e propagadas, mas exclua as propriedades do sistema da enumeração.

Para turmas:

Constante Valor Descrição
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Limite a enumeração a propriedades substituídas na definição de classe.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Limite a enumeração a propriedades substituídas na definição de classe atual e a novas propriedades definidas na classe.
WBEM_MASK_CLASS_CONDITION 0x300 Uma máscara (em vez de um sinalizador) para aplicar a um lEnumFlags valor para verificar se está WBEM_FLAG_CLASS_OVERRIDES_ONLY definido ou WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES se está definido.
WBEM_FLAG_LOCAL_ONLY 0x10 Limite a enumeração a propriedades definidas ou modificadas na própria classe.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Limite a enumeração a propriedades herdadas das classes base.

Para instâncias:

Constante Valor Descrição
WBEM_FLAG_LOCAL_ONLY 0x10 Limite a enumeração a propriedades definidas ou modificadas na própria classe.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Limite a enumeração a propriedades herdadas das classes base.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde 4.7.2

Ver também