다음을 통해 공유

IDynamicKeyProviderConcept::GetKey 메서드(dbgmodel.h)

  • 아티클

동적 키 공급자의 GetKey 메서드는 주로 IModelObject의 GetKey 메서드를 재정의합니다. 동적 키 공급자는 키의 값과 해당 키와 연결된 메타데이터를 반환해야 합니다. 키가 없지만 다른 오류가 발생하지 않는 경우 공급자는 hasKey 매개 변수에서 false를 반환하고 S_OK 성공해야 합니다. 이 호출 실패는 키를 가져오지 못한 것으로 간주되며 부모 모델 체인을 통해 키 검색을 명시적으로 중지합니다. hasKey에서 false를 반환하고 성공하면 키 검색이 계속됩니다.

GetKey가 boxed 속성 접근자를 키로 반환하는 것은 완벽하게 합법적입니다. 이는 속성 접근자를 반환하는 IModelObject 의 GetKey 메서드와 의미상 동일합니다.

구문

HRESULT GetKey(
  IModelObject *contextObject,
  PCWSTR       key,
  IModelObject **keyValue,
  IKeyStore    **metadata,
  bool         *hasKey
);

매개 변수

contextObject

키를 가져올 instance 개체(이 포인터)입니다.

key

검색할 키의 이름입니다.

keyValue

동적 공급자에 의해 결정된 키의 값이 여기에 반환됩니다. 페치에서 오류가 발생하고 잘못된 HRESULT가 반환되면 확장된 오류 정보가 반환됩니다. GetKey 메서드를 구현하여 속성 접근자(IModelPropertyAccessor)를 반환하는 것은 합법적입니다.

metadata

키와 연결된 모든 메타데이터는 선택적으로 여기에 반환될 수 있습니다.

hasKey

동적 공급자에 키가 있는지 여부를 나타내는 표시입니다. 공급자에 키가 없으면 여기서 false를 반환하고 성공해야 합니다.

반환 값

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

요구 사항

요구 사항 값
헤더 dbgmodel.h

추가 정보

IDynamicKeyProviderConcept 인터페이스