피드백

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

  • 아티클
  • 읽는 데 2분 걸림

동적 키 공급자의 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

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

key

검색할 키의 이름입니다.

keyValue

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

metadata

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

hasKey

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

반환 값

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

요구 사항

   
헤더 dbgmodel.h

참고 항목

IDynamicKeyProviderConcept 인터페이스