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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (4.71 或更高版本)