Fonction TranslateURLA (intshcut.h)

Article
08/24/2023

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

Syntaxe

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *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 dans TranslateURL, le système ajoute le protocole par défaut à l’URL.

[out] ppszTranslatedURL

Type : PTSTR*

Variable de pointeur qui reçoit le pointeur vers la chaîne d’URL traduite nouvellement créée, le cas échéant. Le paramètre ppszTranslatedURL est valide uniquement 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.

Remarques

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 comme un 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. Le mélange 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

Condition requise	Valeur
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