IWMDMMetaData::QueryByName 메서드(mswmdm.h)

QueryByName 메서드는 이름으로 지정된 속성의 값을 검색합니다.

구문

HRESULT QueryByName(
  [in]  LPCWSTR           pwszTagName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **pValue,
  [out] UINT              *pcbLength
);

매개 변수

[in] pwszTagName

속성 이름을 지정하는 와이드 문자 null로 끝나는 문자열에 대한 포인터입니다. 표준 속성 이름 상수 목록은 메타데이터 상수에 제공됩니다.

[out] pType

pValue에서 검색된 데이터 형식을 설명하는 WMDM_TAG_DATATYPE 열거형 값입니다.

[out] pValue

메서드가 성공하면 값의 콘텐츠를 수신하는 바이트 배열에 대한 포인터에 대한 포인터입니다. Windows Media 장치 관리자 이 메모리를 할당하고 호출자는 CoTaskMemFree를 사용하여 메모리를 해제해야 합니다.

[out] pcbLength

바이트 배열 ppValue의 크기(바이트)에 대한 포인터입니다. 값이 문자열인 경우 종료 문자가 포함됩니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

• 표준 COM 오류 코드
• HRESULT 값으로 변환된 Windows 오류 코드
• Windows Media 장치 관리자 오류 코드

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	mswmdm.h
라이브러리	Mssachlp.lib

추가 정보

IWMDMMetaData 인터페이스

메타데이터 상수

QueryByIndex

파일에서 메타데이터 설정