IKeyEnumerator::GetNext 메서드(dbgmodel.h)
반복기를 앞으로 이동하고 다음 키의 이름과 필요에 따라 해당 값(또는 해당 키에 대한 참조) 및 관련 메타데이터를 가져옵니다.
이 열거자를 획득한 방법에 따라 값 필드에 반환된 개체는 키(EnumerateKeys), 키가 참조하는 속성의 확인된 값(EnumerateKeyValues) 또는 키에 대한 참조(EnumerateKeyReferences)일 수 있습니다.
키 값을 확인하는 데 오류가 있는 경우(enumerateKeyValues의 경우 instance 경우) 메서드는 오류 및 채우기 값을 오류 개체로 반환할 수 있습니다. 열거자가 시퀀스의 끝에 도달하면 E_BOUNDS 반환됩니다.
구문
HRESULT GetNext(
BSTR *key,
_COM_Errorptr_opt_ IModelObject **value,
IKeyStore **metadata
);
매개 변수
key
열거 중인 키의 이름이 여기에 반환됩니다. 호출자는 SysFreeString 메서드를 사용하여 이 문자열을 해제합니다.
value
열거 중인 키의 값이 여기에 반환됩니다. 열거자를 획득한 방법에 따라 이 값은 키(EnumerateKeys)와 연결된 값, 키가 참조하는 속성의 확인된 값(EnumerateKeyValues) 또는 키에 대한 참조(EnumerateKeyReferences)일 수 있습니다.
metadata
키와 연결된 모든 메타데이터는 필요에 따라 이 인수에 반환됩니다.
반환 값
이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | dbgmodel.h |