IKeyStore::GetKeyValue 메서드(dbgmodel.h)

GetKeyValue 메서드는 메타데이터 저장소 내에서 특정 키의 값을 찾기 위해 클라이언트가 이동하는 첫 번째 메서드입니다. 키 인수로 지정된 키가 저장소 내에 있거나 부모 저장소인 경우 해당 키의 값과 연결된 메타데이터가 반환됩니다. 키 값이 속성 접근자(IModelObject에 박스된 IModelPropertyAccessor)인 경우 속성 접근자의 GetValue 메서드는 GetKeyValue 및 반환된 속성의 기본 값에 의해 자동으로 호출됩니다.

구문

HRESULT GetKeyValue(
  PCWSTR                          key,
  _COM_Errorptr_opt_ IModelObject **object,
  IKeyStore                       **metadata
);

매개 변수

key

값을 반환할 키의 이름입니다.

object

키 값이 여기에 반환됩니다. 키의 값이 속성 접근자이면 속성 접근자에서 GetValue 메서드가 호출되고 해당 기본 값이 여기에 반환됩니다.

metadata

키와 연결된 모든 메타데이터는 선택적으로 여기에 반환됩니다. 두 번째 수준 메타데이터에는 현재 사용되지 않습니다. 따라서 이 인수는 일반적으로 null로 지정되어야 합니다.

반환 값

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

설명

코드 예제

ComPtr<IKeyStore> spMetadata; /* get a metadata store */

ComPtr<IModelObject> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
    // spRadix has the preferred display radix.  Use GetIntrinsicValueAs to unbox.
}

요구 사항

추가 정보

IKeyStore 인터페이스