Fonction InternetCreateUrlA (wininet.h)
Crée une URL à partir de ses composants.
Syntaxe
BOOL InternetCreateUrlA(
[in] LPURL_COMPONENTSA lpUrlComponents,
[in] DWORD dwFlags,
[out] LPSTR lpszUrl,
[in, out] LPDWORD lpdwUrlLength
);
Paramètres
[in] lpUrlComponents
Pointeur vers une structure URL_COMPONENTS qui contient les composants à partir desquels créer l’URL.
[in] dwFlags
Contrôle le fonctionnement de cette fonction. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.
Valeur | Signification |
---|---|
|
Convertit tous les caractères non sécurisés en séquences d’échappement correspondantes dans la chaîne de chemin pointée par le membre lpszUrlPath et dans lpszExtraInfo la chaîne d’informations supplémentaires pointée par le membre de la structure URL_COMPONENTS pointée vers le paramètre lpUrlComponents .
La version Unicode d’InternetCreateUrl va d’abord essayer de convertir à l’aide de la page de code système. En cas d’échec, il revient à UTF-8. |
|
Obsolète : ignoré. |
[out] lpszUrl
Pointeur vers une mémoire tampon qui reçoit l’URL.
[in, out] lpdwUrlLength
Pointeur vers une variable qui spécifie la taille de la mémoire tampon lpszUrl d’URL, dans les TCHAR. Lorsque la fonction retourne, ce paramètre reçoit la taille de la chaîne d’URL, à l’exclusion de la terminaison NULL. Si GetLastError retourne ERROR_INSUFFICIENT_BUFFER, ce paramètre reçoit le nombre d’octets requis pour contenir l’URL créée.
Valeur retournée
Retourne TRUE si la fonction réussit, ou FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Lorsque vous spécifiez un schéma dans la structure URL_COMPONENTS passée à lpUrlComponents, si lpszScheme n’a pas la valeur NULL, il sera utilisé pour le schéma. Si lpszScheme a la valeur NULL, le schéma peut être spécifié à l’aide de l’énumération INTERNET_SCHEME en définissant nScheme sur le INTERNET_SCHEME ou le INTERNET_SCHEME_DEFAULT requis.
Notes
L’en-tête wininet.h définit InternetCreateUrl comme un 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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | wininet.h |
Bibliothèque | Wininet.lib |
DLL | Wininet.dll |