IURLSearchHook2::TranslateWithSearchContext メソッド (shlobj_core.h)

ブラウザーが URL アドレスのプロトコルを判別できない場合にブラウザーによって呼び出されます。 このメソッドは、検索コンテキストを使用してプロトコルを決定します。

構文

HRESULT TranslateWithSearchContext(
  [out]          PWSTR          pwszSearchURL,
                 DWORD          cchBufferSize,
  [in, optional] ISearchContext *pSearchContext
);

パラメーター

[out] pwszSearchURL

種類: PWSTR

入力時に、ブラウザーがプロトコルを決定しようとしている URL アドレスを含むワイド文字バッファーのアドレス。 終了時に、このバッファーには、メソッドが成功した場合に変更された URL アドレスが含まれます。

cchBufferSize

型: DWORD

lpwszSearchURL にあるバッファーのサイズ (文字単位)。

[in, optional] pSearchContext

種類: ISearchContext*

ISearchContext オブジェクトへのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h
[DLL]	Shell32.dll