Método IURLSearchHook::Translate (shlobj_core.h)

  • Artigo

Chamado pelo navegador quando o navegador não pode determinar o protocolo de um endereço de URL.

Sintaxe

HRESULT Translate(
  [out] PWSTR pwszSearchURL,
        DWORD cchBufferSize
);

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. Consulte o valor retornado para obter mais informações.

cchBufferSize

Tipo: DWORD

O tamanho, em caracteres, do buffer em pwszSearchURL.

Valor retornado

Tipo: HRESULT

Esse método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
 O endereço de URL foi completamente traduzido. O parâmetro lpwszSearchURL contém o endereço de URL completo. O navegador não chamará nenhum outro Gancho de Pesquisa de URL e tentará navegar até o endereço modificado.
S_FALSE
 O endereço de URL foi parcialmente processado, mas ainda é necessária uma tradução adicional. O parâmetro lpwszSearchURL contém o resultado do processamento. O navegador continuará executando o restante dos Ganchos de Pesquisa de URL.
E_FAIL
 O endereço de URL não foi traduzido. O parâmetro lpwszSearchURL não foi modificado. O navegador continuará executando o restante dos Ganchos de Pesquisa de URL.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
DLL Shell32.dll (versão 4.71 ou posterior)