Поделиться через

Метод IURLSearchHook::Translate (shlobj_core.h)

  • Статья

Вызывается браузером, если браузер не может определить протокол URL-адреса.

Синтаксис

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

Параметры

[out] pwszSearchURL

Тип: PWSTR

Адрес широкого буфера символов, который в записи содержит URL-адрес, для которого браузер пытается определить протокол. При выходе этот буфер содержит измененный URL-адрес, если метод был успешным. Дополнительные сведения см. в разделе Возвращаемое значение.

cchBufferSize

Тип: DWORD

Размер (в символах) буфера в pwszSearchURL.

Возвращаемое значение

Тип: HRESULT

Этот метод должен возвращать одно из следующих значений.

Код возврата Описание
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
Header shlobj_core.h
DLL Shell32.dll (версия 4.71 или более поздняя)