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

루트 메타데이터 블록을 기준으로 현재 경로를 검색합니다.

구문

HRESULT GetLocation(
  [in]      UINT  cchMaxLength,
  [in, out] WCHAR *wzNamespace,
  [out]     UINT  *pcchActualLength
);

[in] cchMaxLength

형식: UINT

wzNamespace 버퍼의 길이입니다.

[in, out] wzNamespace

형식: WCHAR*

현재 네임스페이스 위치를 수신하는 포인터입니다.

[out] pcchActualLength

형식: UINT*

현재 네임스페이스 위치를 검색하는 데 필요한 실제 버퍼 길이입니다.

형식: HRESULT

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

wzNamespace에 NULL을 전달하는 경우 GetLocation은 cchMaxLength를 무시하고 pcchActualLength가 가리키는 변수에 경로를 저장하는 데 필요한 버퍼 길이를 반환합니다.

쿼리 판독기가 메타데이터 계층 구조의 맨 위에 상대적인 경우 단일 문자 문자열을 반환합니다.

쿼리 판독기가 중첩된 메타데이터 블록을 기준으로 하는 경우 이 메서드는 현재 쿼리 판독기로 경로를 반환합니다.


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

개념