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
| 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 |
Confira também
IWbemClassObject::BeginEnumeration