IWICMetadataQueryReader::GetMetadataByName 메서드(wincodec.h)

메타데이터 쿼리 식으로 식별된 메타데이터 블록 또는 항목을 검색합니다.

구문

HRESULT GetMetadataByName(
  [in]      LPCWSTR     wzName,
  [in, out] PROPVARIANT *pvarValue
);

[in] wzName

형식: LPCWSTR

요청된 메타데이터 블록 또는 항목에 대한 쿼리 식입니다.

[in, out] pvarValue

이 메서드가 반환되면 는 요청된 메타데이터 블록 또는 항목을 포함합니다.

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

GetMetadataByName 은 메타데이터 쿼리 식을 사용하여 포함된 메타데이터에 액세스합니다. 메타데이터 쿼리 언어에 대한 자세한 내용은 메타데이터 쿼리 언어 개요를 참조하세요.

동일한 쿼리 식으로 표현되는 여러 블록 또는 항목이 있는 경우 발견된 첫 번째 메타데이터 블록 또는 항목이 반환됩니다.

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	wincodec.h
라이브러리	Windowscodecs.lib
DLL	Windowscodecs.dll