Método IKeyEnumerator::GetNext (dbgmodel.h)

Move o iterador para frente e busca o nome da próxima chave e, opcionalmente, seu valor (ou uma referência a ele) e metadados associados.

Observe que, dependendo de como esse enumerador foi adquirido, o objeto retornado no campo de valor pode ser o valor associado à chave (EnumerateKeys), o valor resolvido de qualquer propriedade à qual a chave se refere (EnumerateKeyValues) ou uma referência à chave (EnumerateKeyReferences).

Se houver um erro ao resolver o valor da chave (para EnumerateKeyValues, por exemplo), o método poderá retornar um erro E um valor de preenchimento com um objeto de erro. Quando o enumerador atingir o final da sequência, E_BOUNDS será retornado.

Sintaxe

HRESULT GetNext(
  BSTR                            *key,
  _COM_Errorptr_opt_ IModelObject **value,
  IKeyStore                       **metadata
);

Parâmetros

key

O nome da chave que está sendo enumerada é retornado aqui. O chamador é responsável por liberar essa cadeia de caracteres com o método SysFreeString.

value

O valor da chave que está sendo enumerada é retornado aqui. Dependendo de como o enumerador foi adquirido, esse valor pode ser o valor associado à chave (EnumerateKeys), o valor resolvido de qualquer propriedade à qual a chave se refere (EnumerateKeyValues) ou uma referência à chave (EnumerateKeyReferences).

metadata

Os metadados associados à chave são retornados opcionalmente nesse argumento.

Retornar valor

Esse método retorna HRESULT que indica êxito ou falha.

Requisitos

Requisito	Valor
Cabeçalho	dbgmodel.h

Confira também

Interface IKeyEnumerator