Partager via

Fonction TranslateURLW (intshcut.h)

  • Article

Applique des traductions courantes à une chaîne d’URL donnée, en créant une nouvelle chaîne d’URL.

Syntaxe

INTSHCUTAPI HRESULT TranslateURLW(
        PCWSTR pcszURL,
        DWORD  dwInFlags,
  [out] PWSTR  *ppszTranslatedURL
);

Paramètres

pcszURL

Type : PCTSTR

Adresse de la chaîne d’URL à traduire.

dwInFlags

Type : DWORD

Indicateurs de bits qui spécifient la façon dont la chaîne d’URL doit être traduite. Cette valeur peut être une combinaison des éléments suivants :

TRANSLATEURL_FL_GUESS_PROTOCOL

Si le schéma de protocole n’est pas spécifié dans le paramètre pcszURLsur TranslateURL, le système choisit automatiquement un schéma et l’ajoute à l’URL.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

Si le schéma de protocole n’est pas spécifié dans le paramètre pcszURL sur TranslateURL, le système ajoute le protocole par défaut à l’URL.

[out] ppszTranslatedURL

Type : PTSTR*

Variable pointeur qui reçoit le pointeur vers la chaîne d’URL traduite nouvellement créée, le cas échéant. Le paramètre ppszTranslatedURL n’est valide que si la fonction retourne S_OK.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou S_FALSE si l’URL n’a pas besoin d’une traduction. Si une erreur se produit, la fonction retourne l’une des valeurs suivantes.

Code de retour Description
E_FLAGS
 La combinaison d’indicateurs passée dans dwInFlags n’est pas valide.
E_OUTOFMEMORY
 La mémoire était insuffisante pour terminer l’opération.
E_POINTER
 L’un des pointeurs d’entrée n’est pas valide.

Notes

Cette fonction ne valide pas la chaîne d’URL d’entrée. Une valeur de retour réussie n’indique pas que les chaînes d’URL sont des URL valides.

Notes

L’en-tête intshcut.h définit TranslateURL en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête intshcut.h
DLL Url.dll