UDF > WinAPIEx > ShellPath >


_WinAPI_UrlCanonicalize

Convertit une chaîne URL en forme canonique

#include <WinAPIShPath.au3>
_WinAPI_UrlCanonicalize ( $sUrl, $iFlags )

Paramètres

$sUrl L'URL.
$iFlags Les flags qui spécifient comment l'URL doit être converti. Ce paramètre peut être une combinaison des valeurs suivantes:
    $URL_DONT_SIMPLIFY
    $URL_ESCAPE_PERCENT
    $URL_ESCAPE_SPACES_ONLY
    $URL_ESCAPE_UNSAFE
    $URL_NO_META
    $URL_PLUGGABLE_PROTOCOL
    $URL_UNESCAPE

Windows 7 ou une version ultérieure
    $URL_ESCAPE_AS_UTF8

Valeur de retour

Succès: Retourne l'URL convertie.
Échec: Définit @error <> 0, @extended peut contenir le code d'erreur HRESULT.

Remarque

Si une chaîne URL contient "/../" ou "/./", _WinAPI_UrlCanonicalize() traite habituellement les caractères comme s'ils indiquaient une navigation dans la hiérarchie de l'URL. La fonction simplifie les URL(s) avant de les combiner. Par exemple, "/hello/cruel/../world" est simplifiée en "/hello/world". Si le flag $URL_DONT_SIMPLIFY est activé, la fonction ne simplifie pas les URLs. Dans ce cas, "/hello/cruel/../world" est laissée telle quelle.

Voir aussi

Consultez UrlCanonicalize dans la librairie MSDN.

Exemple

#include <APIShPathConstants.au3>
#include <WinAPIShPath.au3>

Local $sUrl = 'http://msdn.microsoft.com/en-us/library/ee663300%28VS.85%29.aspx'

ConsoleWrite( _WinAPI_UrlCanonicalize($sUrl, $URL_UNESCAPE) & @CRLF)