IMFAttributes::GetItem 메서드(mfobjects.h)

키와 연결된 값을 검색합니다.

구문

HRESULT GetItem(
  [in]      REFGUID     guidKey,
  [in, out] PROPVARIANT *pValue
);

매개 변수

[in] guidKey

검색할 값을 식별하는 GUID입니다.

[in, out] pValue

값을 받는 PROPVARIANT 에 대한 포인터입니다. 메서드는 값이 발견되면 PROPVARIANT 를 저장된 값의 복사본으로 채웁니다. PropVariantClear를 호출하여 이 메서드에서 할당한 메모리를 해제합니다. 이 매개 변수는 NULL일 수 있습니다. 이 매개 변수가 NULL이면 메서드는 키를 검색하고 키가 발견되면 S_OK 반환하지만 값을 복사하지는 않습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_ATTRIBUTENOTFOUND	지정된 키를 찾을 수 없습니다.

설명

이 인터페이스는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

• Windows XP SP2(서비스 팩 2) 이상
• KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)가 설치된 Windows XP Media Center Edition 2005.

예제

다음 예제에서는 특성을 한 특성 저장소에서 다른 특성 저장소로 복사합니다.

HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
    PROPVARIANT val;

    HRESULT hr = pFrom->GetItem(guidKey, &val);

    if (SUCCEEDED(hr))
    {
        hr = pTo->SetItem(guidKey, val);
        PropVariantClear(&val);
    }
    else if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        hr = S_OK;
    }
    return hr;
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	mfobjects.h(Mfidl.h 포함)
라이브러리	Mfuuid.lib

추가 정보

특성 및 속성

IMFAttributes