Fonction InternetCreateUrlA (wininet.h)

  • Article

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
ICU_ESCAPE
 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.
ICU_USERNAME
 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.

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).
 

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

Voir aussi

Gestion des localisateurs de ressources uniformes

Fonctions WinINet