Share via


Método IURLSearchHook2::TranslateWithSearchContext (shlobj_core.h)

Chamado pelo navegador quando o navegador não pode determinar o protocolo de um endereço de URL. Esse método usa um contexto de pesquisa para determinar o protocolo.

Sintaxe

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

Parâmetros

[out] pwszSearchURL

Tipo: PWSTR

O endereço de um buffer de caracteres largo que, na entrada, contém o endereço de URL para o qual o navegador está tentando determinar o protocolo. Na saída, esse buffer conterá o endereço de URL modificado se o método tiver sido bem-sucedido.

cchBufferSize

Tipo: DWORD

O tamanho, em caracteres, do buffer em lpwszSearchURL.

[in, optional] pSearchContext

Tipo: ISearchContext*

Um ponteiro para um objeto ISearchContext . Este parâmetro pode ser NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
DLL Shell32.dll