다음을 통해 공유

IURLSearchHook::Translate 메서드(shlobj_core.h)

  • 아티클

브라우저에서 URL 주소의 프로토콜을 확인할 수 없는 경우 브라우저에서 호출됩니다.

구문

HRESULT Translate(
  [out] PWSTR pwszSearchURL,
        DWORD cchBufferSize
);

매개 변수

[out] pwszSearchURL

형식: PWSTR

항목에서 브라우저가 프로토콜을 확인하려는 URL 주소를 포함하는 와이드 문자 버퍼의 주소입니다. 종료할 때 메서드가 성공한 경우 이 버퍼에는 수정된 URL 주소가 포함됩니다. 자세한 내용은 반환 값을 참조하세요.

cchBufferSize

형식:DWORD

pwszSearchURL에 있는 버퍼의 크기(문자)입니다.

반환 값

형식: HRESULT

이 메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드 Description
S_OK
 URL 주소가 완전히 변환되었습니다. lpwszSearchURL 매개 변수에는 전체 URL 주소가 포함됩니다. 브라우저는 다른 URL 검색 후크를 호출하지 않으며 수정된 주소로 이동하려고 시도합니다.
S_FALSE
 URL 주소가 부분적으로 처리되었지만 추가 변환은 여전히 필요합니다. lpwszSearchURL 매개 변수는 처리 결과를 포함합니다. 브라우저는 나머지 URL 검색 후크를 계속 실행합니다.
E_FAIL
 URL 주소가 번역되지 않았습니다. lpwszSearchURL 매개 변수가 수정되지 않았습니다. 브라우저는 나머지 URL 검색 후크를 계속 실행합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shlobj_core.h
DLL Shell32.dll(버전 4.71 이상)