TranslateURLA, fonction (intshcut.h)

Article
11/20/2024

Applique les traductions courantes à une chaîne d’URL donnée, en créant une nouvelle 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 pcszURL pour 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 à 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 nouvellement créée et traduite, le cas échéant. Le paramètre ppszTranslatedURL est valide uniquement si la fonction retourne S_OK.

Valeur de retour

Type : HRESULT

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

Retourner le code	Description
E_FLAGS	La combinaison d’indicateurs passée dans dwInFlags n’est pas valide.
E_OUTOFMEMORY	Il n’y avait pas de mémoire suffisante 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.

Note

L’en-tête intshcut.h définit TranslateURL comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	intshcut.h
DLL	Url.dll

Partager via