共用方式為

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 版或更新版本)