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 |