次の方法で共有

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 以降)