Fonction TranslateURLW (intshcut.h)
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 |
---|---|
|
La combinaison d’indicateurs passée dans dwInFlags n’est pas valide. |
|
La mémoire était insuffisante pour terminer l’opération. |
|
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 |