Método IKeyEnumerator::GetNext (dbgmodel.h)
Mueve el iterador hacia delante y captura el nombre de la siguiente clave y, opcionalmente, su valor (o una referencia a él) y los metadatos asociados.
Tenga en cuenta que, dependiendo de cómo se adquirió este enumerador, el objeto devuelto en el campo de valor puede ser el valor asociado a la clave (EnumerateKeys), el valor resuelto de cualquier propiedad a la que hace referencia la clave (EnumerateKeyValues) o una referencia a la clave (EnumerateKeyReferences).
Si se produjo un error al resolver el valor de la clave (para EnumerateKeyValues, por ejemplo), el método puede devolver un valor de error AND fill con un objeto error. Cuando el enumerador alcanza el final de la secuencia, se devolverá E_BOUNDS.
Sintaxis
HRESULT GetNext(
BSTR *key,
_COM_Errorptr_opt_ IModelObject **value,
IKeyStore **metadata
);
Parámetros
key
El nombre de la clave que se enumera se devuelve aquí. El autor de la llamada es responsable de liberar esta cadena con el método SysFreeString.
value
El valor de la clave que se enumera se devuelve aquí. Dependiendo de cómo se adquirió el enumerador, este valor puede ser el valor asociado a la clave (EnumerateKeys), el valor resuelto de cualquier propiedad a la que hace referencia la clave (EnumerateKeyValues) o una referencia a la clave (EnumerateKeyReferences).
metadata
Los metadatos asociados a la clave se devuelven opcionalmente en este argumento.
Valor devuelto
Este método devuelve HRESULT que indica éxito o error.
Requisitos
| Requisito | Valor |
|---|---|
| Header | dbgmodel.h |