Метод IKeyEnumerator::GetNext (dbgmodel.h)
Перемещает итератор вперед и получает имя следующего ключа, при необходимости его значение (или ссылку на него) и связанные метаданные.
Обратите внимание, что в зависимости от способа получения перечислителя объект, возвращаемый в поле значения, может быть значением, связанным с ключом (EnumerateKeys), разрешенным значением любого свойства, на которое ссылается ключ (EnumerateKeyValues), или ссылкой на ключ (EnumerateKeyReferences).
Если произошла ошибка при разрешении значения ключа (например, для EnumerateKeyValues), метод может вернуть значение error AND fill с объектом error. Когда перечислитель достигает конца последовательности, возвращается E_BOUNDS.
Синтаксис
HRESULT GetNext(
BSTR *key,
_COM_Errorptr_opt_ IModelObject **value,
IKeyStore **metadata
);
Параметры
key
Здесь возвращается имя перечисляемого ключа. Вызывающий объект отвечает за освобождение этой строки с помощью метода SysFreeString.
value
Здесь возвращается значение перечисляемого ключа. В зависимости от способа получения перечислителя это значение может быть значением, связанным с ключом (EnumerateKeys), разрешенным значением любого свойства, на которое ссылается ключ (EnumerateKeyValues), или ссылкой на ключ (EnumerateKeyReferences).
metadata
Все метаданные, связанные с ключом, при необходимости возвращаются в этом аргументе.
Возвращаемое значение
Этот метод возвращает HRESULT, который указывает на успех или сбой.
Требования
| Требование | Значение |
|---|---|
| Заголовок | dbgmodel.h |