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

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

Confira também

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::EndEnumeration

IWbemClassObject::Get

Propriedades do sistema do WMI