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 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
URLIS_URL
L’URL est-elle valide ?
Valeur de retour
Type : BOOL
Pour tous les types d’URL, URLIs retourne TRUE si l’URL est le type spécifié, ou FALSE si ce n’est pas le cas.
Si url est définie sur URLIS_APPLIABLE, URL 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 sinon.
Remarques
Note
L’en-tête shlwapi.h définit les URL 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. 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 2000 Professionnel, 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 | shlwapi.h |
| bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |