Função seguinte

Artigo
04/11/2023

Obtém a propriedade seguinte numa enumeração que começa com uma chamada para BeginEnumeration.

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 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 não é utilizado.

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

lFlags
[in] Reservado. Este parâmetro tem de ser 0.

pstrName
[fora] Um novo BSTR que contém o nome da propriedade. Pode definir este parâmetro como null se o nome não for necessário.

pVal
[fora] Um VARIANT preenchido com o valor da propriedade . Pode definir este parâmetro como null se o valor não for necessário. Se a função devolver um código de erro, o VARIANT transmitido para pVal não será modificado.

pvtType
[fora] Um ponteiro para uma CIMTYPE variável ( LONG na qual o tipo da propriedade é colocado). O valor desta propriedade pode ser um VT_NULL_VARIANT, caso em que é necessário determinar o tipo real da propriedade. Este parâmetro também pode ser null.

plFlavor
[out] null, ou um valor que recebe informações sobre a origem da propriedade. Veja a secção [Observações] para obter os valores possíveis.

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_FAILED`	0x80041001	Houve uma falha geral.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Um parâmetro é inválido.
`WBEM_E_UNEXPECTED`	0x8004101d	Não houve nenhuma chamada para a `BeginEnumeration` função.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não existe memória suficiente disponível para iniciar uma nova enumeração.
`WBEM_E_TRANSPORT_FAILURE`	0x80041015	A chamada de procedimento remoto entre o processo atual e a Gestão do Windows falhou.
`WBEM_S_NO_ERROR`	0	A chamada da função foi efetuada com êxito.
`WBEM_S_NO_MORE_DATA`	0x40005	Não existem mais propriedades na enumeração.

Observações

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

Este método também devolve propriedades do sistema.

Se o tipo subjacente da propriedade for um caminho de objeto, uma data ou hora ou outro tipo especial, o tipo devolvido não contém informações suficientes. O autor da chamada tem de examinar o CIMTYPE para a propriedade especificada para determinar se a propriedade é uma referência de objeto, uma data ou hora ou outro tipo especial.

Se plFlavor não nullfor , o LONG valor recebe informações sobre a origem da propriedade, da seguinte forma:

Constante	Valor	Descrição
`WBEM_FLAVOR_ORIGIN_SYSTEM`	0x40	A propriedade é uma propriedade de sistema padrão.
`WBEM_FLAVOR_ORIGIN_PROPAGATED`	0x20	Para uma classe: a propriedade é herdada da classe principal. Por exemplo: a propriedade, embora herdada da classe principal, não foi modificada pela instância.
`WBEM_FLAVOR_ORIGIN_LOCAL`	0	Para uma classe: a propriedade pertence à classe derivada. Por exemplo: a propriedade é modificada pela instância; ou seja, foi fornecido um valor ou foi adicionado ou modificado um qualificador.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde a versão 4.7.2

Ver também

WMI e Contadores de Desempenho (Referência da API Não Gerida)

Partilhar via