다음을 통해 공유


IKeyEnumerator::GetNext 메서드(dbgmodel.h)

반복기를 앞으로 이동하고 다음 키의 이름과 필요에 따라 해당 값(또는 해당 키에 대한 참조) 및 연결된 메타데이터를 가져옵니다.

이 열거자를 획득한 방법에 따라 값 필드에 반환된 개체는 키와 연결된 값(EnumerateKeys), 키가 참조하는 속성의 확인된 값(EnumerateKeyValues) 또는 키에 대한 참조(EnumerateKeyReferences)일 수 있습니다.

예를 들어 EnumerateKeyValues의 경우 키 값을 확인하는 동안 오류가 발생한 경우 메서드는 오류 개체로 채우기 값을 오류를 반환할 수 있습니다. 열거자가 시퀀스의 끝에 도달하면 E_BOUNDS 반환됩니다.

통사론

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

매개 변수

key

열거 중인 키의 이름이 여기에 반환됩니다. 호출자는 SysFreeString 메서드를 사용하여 이 문자열을 해제합니다.

value

열거 중인 키의 값이 여기에 반환됩니다. 열거자를 획득한 방법에 따라 이 값은 키(EnumerateKeys), 키가 참조하는 속성의 확인된 값(EnumerateKeyValues) 또는 키에 대한 참조(EnumerateKeyReferences)와 연결된 값일 수 있습니다.

metadata

키와 연결된 모든 메타데이터는 필요에 따라 이 인수에 반환됩니다.

반환 값

이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다.

요구 사항

요구
헤더 dbgmodel.h

참고 항목

IKeyEnumerator 인터페이스