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
ヘッダー	shlobj_core.h
[DLL]	Shell32.dll (バージョン 4.71 以降)