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

  • Artículo

Llamado por el explorador cuando el explorador no puede determinar el protocolo de una dirección URL.

Sintaxis

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

Parámetros

[out] pwszSearchURL

Tipo: PWSTR

La dirección de un búfer de caracteres anchos que, en la entrada, contiene la dirección URL para la que el explorador está intentando determinar el protocolo. Al salir, este búfer contiene la dirección URL modificada si el método se realizó correctamente. Consulte el valor devuelto para obtener más información.

cchBufferSize

Tipo: DWORD

Tamaño, en caracteres, del búfer en pwszSearchURL.

Valor devuelto

Tipo: HRESULT

Este método debe devolver uno de los siguientes valores.

Código devuelto Descripción
S_OK
 La dirección URL se traducía por completo. El parámetro lpwszSearchURL contiene la dirección URL completa. El explorador no llamará a ningún otro enlace de búsqueda de direcciones URL e intentará ir a la dirección modificada.
S_FALSE
 La dirección URL se ha procesado parcialmente, pero todavía se requiere una traducción adicional. El parámetro lpwszSearchURL contiene el resultado del procesamiento. El explorador seguirá ejecutando el resto de los enlaces de búsqueda de direcciones URL.
E_FAIL
 La dirección URL no se ha traducido. No se ha modificado el parámetro lpwszSearchURL . El explorador seguirá ejecutando el resto de los enlaces de búsqueda de direcciones URL.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h
Archivo DLL Shell32.dll (versión 4.71 o posterior)