Le Centre W..D..

Meilleure résolution
mode 800 x 600

Optimisé pour
IE v.5
Netscape v.6
mais surtout pour
Mozilla v.1
minimum

Membre de Click-FR®, Réseau francophone Paie-Par-Click

UrlEscape

Date de parution : 24/11/2002 - Cette fiche API a été lue 1146 fois

Description

UrlEscape permet la conversion dans une URL des espaces par la séquence d'échappement correspondante (%20). La fonction retourne S_OK en cas de succès ou un message d'erreur OLE standard.

Syntaxe

AppelDLL32("shlwapi", "UrlEscapeA", &pszUrl, &pszEscaped, &pcchEscaped, dwFlags)

pszURL

[e] Pointeur sur une chaîne à terminateur nul qui contient l'URL.

pszEscaped

[s] Pointeur sur une chaîne à terminateur nul qui contient l'URL transformée.

pcchEscaped

[e/s] Nombre de caractères retourné dans pszEscaped

dwFlags

[e] Sémaphore de personnalisation de la chaîne :

Valeur	Signification
`URL_ESCAPE_SPACES_ONLY = 0x4000000`	Convertir uniquement les espaces en séquence d'échappement.
`URL_ESCAPE_PERCENT = 0x1000`	Convertir uniquement le caractère '%' en sa séquence d'échappement.
`URL_ESCAPE_SEGMENT_ONLY = 0x2000`	Convertir tous les caractères sauf '#' et '?'.
`URL_DONT_ESCAPE_EXTRA_INFO = 0x2000000`	Ne pas convertir les '#' et '?' et tous les caractères venant derrière.

Compatibilité

Supporté pour toutes les versions à partir d'Internet Explorer 5.0 et shlwapi.dll version 5.0 minimum

Remarque

D'après la documentation MSDN précise qu'il existe une fonction UrlEscapeSpaces. Bien qu'ayant une version 5.00.2919.6304 de shlwapi.dll, celle-ci est introuvable.

Exemple 1

// Remplacer les espaces par les séquences échap d'une URL
pszUrl est une chaîne Asciiz sur 260
pszEsc est une chaîne Asciiz sur 260
cch est un entier = 260
pszUrl = "http://www.beaussier.com/montrez moi un exemple/"
CallDll32("shlwapi", "UrlEscapeA", &pszUrl, &pszEsc, &cch, 0x8000000)
Info(pszEsc)

Nombre de commentaire sur UrlEscape : 0

Rappel : Le code fourni est compatible Windev v.4 et 5. Pour les versions supérieures, vous devez modifier le type des variables numériques. Par exemple : entier long devient entier.
Bien sûr, les marques citées sont déposées par leurs sociétés respectives. Ces pages sont à la disposition de tous, le code fourni est libre mais toute responsabilité est déclinée en cas de mauvais usage ou de dysfonctionnement.
© 2000-2005 Beaussier & Le Centre W..D..