InternetCombineUrlA, fonction (wininet.h)

Article
11/20/2024

Combine une URL de base et relative en une seule URL. L’URL résultante est canonique (voir InternetCanonicalizeUrl).

Syntaxe

BOOL InternetCombineUrlA(
  [in]      LPCSTR  lpszBaseUrl,
  [in]      LPCSTR  lpszRelativeUrl,
  [out]     LPSTR   lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength,
  [in]      DWORD   dwFlags
);

Paramètres

[in] lpszBaseUrl

Pointeur vers une chaîne terminée par null qui contient l’URL de base.

[in] lpszRelativeUrl

Pointeur vers une chaîne terminée par null qui contient l’URL relative.

[out] lpszBuffer

Pointeur vers une mémoire tampon qui reçoit l’URL combinée.

[in, out] lpdwBufferLength

Pointeur vers une variable qui contient la taille de la mémoire tampon lpszBuffer, en caractères. Si la fonction réussit, ce paramètre reçoit la taille de l’URL combinée, en caractères, sans inclure le caractère de fin null. Si la fonction échoue, ce paramètre reçoit la taille de la mémoire tampon requise, en caractères (y compris le caractère de fin null).

[in] dwFlags

Contrôle l’opération de la fonction. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
ICU_BROWSER_MODE	N’encode pas ou ne décode pas les caractères après « # » ou « ? », et ne supprime pas l’espace blanc de fin après « ? ». Si cette valeur n’est pas spécifiée, l’URL entière est encodée et l’espace blanc de fin est supprimé.
ICU_DECODE	Convertit toutes les séquences %XX en caractères, y compris les séquences d’échappement, avant l’analyse de l’URL.
ICU_ENCODE_PERCENT	Encode tous les signes de pourcentage rencontrés. Par défaut, les signes de pourcentage ne sont pas encodés. Cette valeur est disponible dans Microsoft Internet Explorer 5 et versions ultérieures.
ICU_ENCODE_SPACES_ONLY	Encode les espaces uniquement.
ICU_NO_ENCODE	Ne convertit pas les caractères non sécurisés en séquences d’échappement.
ICU_NO_META	Ne supprime pas les séquences méta (telles que « » et « . . ») de l’URL.

Valeur de retour

Retourne TRUE en cas de réussite ou FALSE sinon. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Les erreurs possibles sont les suivantes.

Retourner le code	Description
ERROR_BAD_PATHNAME	Les URL n’ont pas pu être combinées.
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon fournie à la fonction était insuffisante ou NULL. La valeur indiquée par le paramètre lpdwBufferLength contiendra le nombre d’octets requis pour contenir l’URL combinée.
ERROR_INTERNET_INVALID_URL	Le format de l’URL n’est pas valide.
ERROR_INVALID_PARAMETER	Il existe une chaîne, une mémoire tampon, une taille de mémoire tampon ou un paramètre d’indicateur non valide.

Remarques

Remarque 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).

Note

L’en-tête wininet.h définit InternetCombineUrl 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. 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 [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wininet.h
bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

gestion des localisateurs de ressources uniformes

fonctions WinINet

Partager via