structure URL_COMPONENTSA (wininet.h)

Article
03/04/2024

Contient les parties constituantes d’une URL. Cette structure est utilisée avec les fonctions InternetCrackUrl et InternetCreateUrl .

Syntaxe

typedef struct {
  DWORD           dwStructSize;
  LPSTR           lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPSTR           lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPSTR           lpszUserName;
  DWORD           dwUserNameLength;
  LPSTR           lpszPassword;
  DWORD           dwPasswordLength;
  LPSTR           lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPSTR           lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTSA, *LPURL_COMPONENTSA;

Membres

dwStructSize

Taille de cette structure, en octets.

lpszScheme

Pointeur vers une chaîne qui contient le nom du schéma.

dwSchemeLength

Taille du nom du schéma, en TCHAR.

nScheme

INTERNET_SCHEME valeur qui indique le schéma de protocole Internet.

lpszHostName

Pointeur vers une chaîne qui contient le nom d’hôte.

dwHostNameLength

Taille du nom d’hôte, en TCHAR.

nPort

Numéro de port converti.

lpszUserName

Pointeur vers une valeur de chaîne qui contient le nom d’utilisateur.

dwUserNameLength

Taille du nom d’utilisateur, en TCHAR.

lpszPassword

Pointeur vers une chaîne qui contient le mot de passe.

dwPasswordLength

Taille du mot de passe, en TCHAR.

lpszUrlPath

Pointeur vers une chaîne qui contient le chemin d’URL.

dwUrlPathLength

Taille du chemin d’URL, en TCHAR.

lpszExtraInfo

Pointeur vers une chaîne qui contient les informations supplémentaires (par exemple ,quelque chose ou #something).

dwExtraInfoLength

Taille des informations supplémentaires, dans TCHAR.

Remarques

Pour InternetCrackUrl, si un membre de pointeur et son membre de longueur correspondant sont tous deux zéro, ce composant n’est pas retourné. Si le membre du pointeur a la valeur NULL , mais que le membre de longueur n’est pas égal à zéro, le pointeur et les membres de longueur sont retournés. Si le pointeur et les membres de longueur correspondants ne sont pas nuls, le membre pointeur pointe vers une mémoire tampon où le composant est copié. Le composant peut être supprimé d’une séquence d’échappement, en fonction du paramètre dwFlags d’InternetCrackUrl.

Pour InternetCreateUrl, les membres du pointeur doivent avoir la valeur NULL si le composant n’est pas requis. Si le membre de longueur correspondant est égal à zéro, le membre de pointeur est l’adresse d’une chaîne terminée à zéro. Si le membre de longueur n’est pas égal à zéro, il s’agit de la longueur de chaîne du membre de pointeur correspondant.

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 URL_COMPONENTS 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]
En-tête	wininet.h

Voir aussi

InternetCrackUrl

InternetCreateUrl

Partager via