Partager via

IURLSearchHook::Translate, méthode (shlobj_core.h)

  • Article

Appelé par le navigateur lorsque le navigateur ne peut pas déterminer le protocole d’une adresse URL.

Syntaxe

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

Paramètres

[out] pwszSearchURL

Type : PWSTR

Adresse d’une mémoire tampon de caractères large qui, lors de l’entrée, contient l’adresse URL pour laquelle le navigateur tente de déterminer le protocole. À la sortie, cette mémoire tampon contient l’adresse URL modifiée si la méthode a réussi. Pour plus d’informations, consultez la valeur de retour.

cchBufferSize

Type : DWORD

Taille, en caractères, de la mémoire tampon sur pwszSearchURL.

Valeur retournée

Type : HRESULT

Cette méthode doit retourner l’une des valeurs suivantes.

Code de retour Description
S_OK
 L’adresse URL a été entièrement traduite. Le paramètre lpwszSearchURL contient l’adresse URL complète. Le navigateur n’appelle pas d’autres crochets de recherche d’URL et tente d’accéder à l’adresse modifiée.
S_FALSE
 L’adresse URL a été partiellement traitée, mais une traduction supplémentaire est toujours nécessaire. Le paramètre lpwszSearchURL contient le résultat du traitement. Le navigateur continuera à exécuter le reste des hooks de recherche d’URL.
E_FAIL
 L’adresse URL n’a pas été traduite. Le paramètre lpwszSearchURL n’a pas été modifié. Le navigateur continuera à exécuter le reste des hooks de recherche d’URL.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h
DLL Shell32.dll (version 4.71 ou ultérieure)