Edit

IURLSearchHook2::TranslateWithSearchContext method (shlobj_core.h)

  • Article

Called by the browser when the browser cannot determine the protocol of a URL address. This method uses a search context to determine the protocol.

Syntax

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

Parameters

[out] pwszSearchURL

Type: PWSTR

The address of a wide character buffer that, on entry, contains the URL address for which the browser is trying to determine the protocol. On exit, this buffer contains the modified URL address if the method was successful.

cchBufferSize

Type: DWORD

The size, in characters, of the buffer at lpwszSearchURL.

[in, optional] pSearchContext

Type: ISearchContext*

A pointer to an ISearchContext object. This parameter can be NULL.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h
DLL Shell32.dll