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

Статья
03/15/2023

Вызывается браузером, если браузер не может определить протокол 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 или более поздняя)

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