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

  • 아티클

GetKeyValue 메서드는 이름별로 지정된 키의 값(및 연결된 메타데이터)을 가져오기 위해 클라이언트가 설정하는 첫 번째 메서드입니다. 키가 속성 접근자인 경우 즉, Boxed IModelPropertyAccessor인 IModelObject 값인 경우 GetKeyValue 메서드는 실제 값을 검색하기 위해 속성 접근자의 GetValue 메서드를 자동으로 호출합니다.

구문

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

매개 변수

key

값을 가져올 키의 이름입니다.

object

키의 값은 이 인수에 반환됩니다. 일부 오류의 경우 메서드가 실패한 HRESULT를 반환하더라도 이 인수에서 확장된 오류 정보가 전달될 수 있습니다.

metadata

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

반환 값

이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다. E_BOUNDS 반환 값(또는 경우에 따라 E_NOT_SET)은 키를 찾을 수 없음을 나타냅니다.

설명

코드 예제

ComPtr<IModelObject> spProcess; /* get a process object */

ComPtr<IModelObject> spProcId;
if (SUCCEEDED(spProcess->GetKeyValue(L"Id", &spProcId, nullptr)))
{
    // spProcId has a boxed process id.  Use GetIntrinsicValueAs to unbox it.
}

요구 사항

요구 사항 값
헤더 dbgmodel.h

추가 정보

IModelObject 인터페이스