structure URL_COMPONENTSA (wininet.h)

Article
11/20/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, dans TCHARs .

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, dans 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, dans TCHAR .

lpszPassword

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

dwPasswordLength

Taille du mot de passe, dans TCHAR.

lpszUrlPath

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

dwUrlPathLength

Taille du chemin d’URL, dans 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 pointeur et son membre de longueur correspondant sont tous deux zéro, ce composant n’est pas retourné. Si le membre du pointeur est NULL, mais que le membre de longueur n’est pas égal à zéro, les membres de pointeur et de longueur sont retournés. Si les membres de longueur et de pointeur correspondants ne sont pas zéro, le membre pointeur pointe vers une mémoire tampon où le composant est copié. Le composant peut être non échappé, selon le paramètre dwFlags de InternetCrackUrl.

Pour internetCreateUrl, les membres du pointeur doivent être NULL si le composant n’est pas obligatoire. Si le membre de longueur correspondant est égal à zéro, le membre pointeur est l’adresse d’une chaîne terminée par 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.

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

Voir aussi

InternetCrackUrl

InternetCreateUrl

Partager via