Compartilhar via

Função BeginEnumeration

  • Artigo

Redefine um enumerador de volta ao início da enumeração.

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

Sintaxe

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

Parâmetros

vFunc
[in] Esse parâmetro não está em uso.

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

lEnumFlags
[in] Uma combinação bit a bit dos sinalizadores ou valores descritos na seção Comentários que controla as propriedades a serem incluídos na enumeração.

Valor retornado

Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em seu código:

Constante Valor Descrição
WBEM_E_INVALID_PARAMETER 0x80041008 A combinação de sinalizadores em lEnumFlags é inválida ou um argumento inválido foi especificado.
WBEM_E_UNEXPECTED 0x8004101d Uma segunda chamada para BeginEnumeration foi feita sem uma chamada intervindo para EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Não há memória suficiente disponível para iniciar uma nova enumeração.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.

Comentários

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

Os sinalizadores que podem ser passados como o argumento lEnumFlags são definidos no arquivo de cabeçalho WbemCli.h ou você pode defini-los como constantes em seu código. Você 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 objeto.

Grupo 2

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

Para classes:

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 às propriedades substituídas na definição de classe atual e às novas propriedades definidas na classe.
WBEM_MASK_CLASS_CONDITION 0x300 Uma máscara (em vez de um sinalizador) a ser aplicada a um valor lEnumFlags para verificar se um WBEM_FLAG_CLASS_OVERRIDES_ONLY ou WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 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 às 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 às propriedades herdadas das classes base.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

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

Confira também