Método IWbemClassObject::Next (wbemcli.h)

Artigo
08/27/2023

O método IWbemClassObject::Next recupera a próxima propriedade em uma enumeração que começou com IWbemClassObject::BeginEnumeration. Isso deve ser chamado repetidamente para enumerar todas as propriedades até que WBEM_S_NO_MORE_DATA retorne. Se a enumeração for encerrada antecipadamente, IWbemClassObject::EndEnumeration deverá ser chamado.

A ordem das propriedades retornadas durante a enumeração não está definida.

Sintaxe

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

Parâmetros

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[out] strName

Recebe um novo BSTR que contém o nome da propriedade. Para evitar vazamentos de memória no processo do cliente, o chamador deve chamar SysFreeString quando o nome não for mais necessário. Você poderá definir esse parâmetro como NULL se o nome não for necessário.

[out] pVal

Essa VARIANT é preenchida com o valor da propriedade . O método chama VariantInit nessa VARIANT, portanto, o chamador deve garantir que o VARIANT não esteja ativo antes da chamada. O chamador deve usar VariantClear quando o valor não for mais necessário.

Você poderá definir esse parâmetro como NULL se o valor não for necessário. Se um código de erro for retornado, a VARIANT apontada por pVal será deixada sem modificação.

[out, optional] pType

Este parâmetro pode ser NULL. Se não for NULL, ele deverá apontar para uma variável CIMTYPE (um LONG) na qual o tipo da propriedade é colocado. É possível que o valor dessa propriedade possa ser um VT_NULLVARIANT, nesse caso, é necessário determinar o tipo real da propriedade.

[out, optional] plFlavor

Pode ser NULL. Se não for NULL, o valor LONG apontado para receberá informações sobre a origem da propriedade da seguinte maneira. Para obter mais informações, consulte Tipos de qualificador e WBEM_FLAVOR_TYPE.

WBEM_FLAVOR_ORIGIN_SYSTEM

A propriedade é uma propriedade padrão do sistema.

Para classes:

WBEM_FLAVOR_ORIGIN_PROPAGATED

A propriedade foi herdada da classe pai.

A propriedade, embora herdada da classe pai, não foi modificada no nível da instância.

WBEM_FLAVOR_ORIGIN_LOCAL

A propriedade pertence à classe mais derivada.

A propriedade é modificada no nível da instância (ou seja, um valor foi fornecido ou um qualificador foi adicionado/modificado).

Para instâncias:

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Comentários

Se o tipo subjacente da propriedade for um caminho de objeto, data ou hora ou outro tipo especial, o tipo retornado não conterá informações suficientes. O chamador deve examinar o CIMTYPE para a propriedade especificada e determinar se a propriedade é uma referência de objeto, data ou hora ou outro tipo especial.

Esse método também retorna propriedades do sistema.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (inclua Wbemidl.h)
Biblioteca	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll