Fonction InternetCreateUrlW (wininet.h)
Crée une URL à partir de ses composants.
Syntaxe
BOOL InternetCreateUrlW(
[in] LPURL_COMPONENTSW lpUrlComponents,
[in] DWORD dwFlags,
[out] LPWSTR 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 vers laquelle pointe 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 par le paramètre lpUrlComponents .
La version Unicode d’InternetCreateUrl va d’abord essayer de convertir à l’aide de la page de codes 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 marque de fin 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
Lors de la spécification d’un schéma dans la structure URL_COMPONENTS passée à lpUrlComponents, si lpszScheme n’a pas la valeur NULL, il est 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 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. 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 [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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour