UrlIsA, fonction (shlwapi.h)
Teste si une URL est un type spécifié.
Syntaxe
BOOL UrlIsA(
[in] PCSTR pszUrl,
URLIS UrlIs
);
Paramètres
[in] pszUrl
Type : PCTSTR
Chaîne terminée par un caractère Null de longueur maximale INTERNET_MAX_URL_LENGTH qui contient l’URL.
UrlIs
Type : URLIS
Type d’URL à tester. Ce paramètre peut prendre l’une des valeurs suivantes.
URLIS_APPLIABLE
Essayez de déterminer un schéma valide pour l’URL.
URLIS_DIRECTORY
La chaîne d’URL se termine-t-elle par un répertoire ?
URLIS_FILEURL
L’URL est-elle une URL de fichier ?
URLIS_HASQUERY
L’URL a-t-elle une chaîne de requête ajoutée ?
URLIS_NOHISTORY
L’URL est-elle une URL qui n’est généralement pas suivie dans l’historique de navigation ?
URLIS_OPAQUE
L’URL est-elle opaque ?
URLIS_URL
L’URL est-elle valide ?
Valeur retournée
Type : BOOL
Pour tous les types d’URL sauf un, UrlIs retourne TRUE si l’URL est le type spécifié, ou FALSE si ce n’est pas le cas.
Si UrlIs est défini sur URLIS_APPLIABLE, urlis tente de déterminer le schéma d’URL. Si la fonction est en mesure de déterminer un schéma, elle retourne TRUE ou FALSE dans le cas contraire.
Remarques
Notes
L’en-tête shlwapi.h définit urlis 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. 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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| Bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |