URL_COMPONENTS structure (winhttp.h)

Article
08/27/2023

La structure URL_COMPONENTS contient les parties constituantes d’une URL. Cette structure est utilisée avec les fonctions WinHttpCrackUrl et WinHttpCreateUrl .

Syntaxe

typedef struct _WINHTTP_URL_COMPONENTS {
  DWORD           dwStructSize;
  LPWSTR          lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPWSTR          lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPWSTR          lpszUserName;
  DWORD           dwUserNameLength;
  LPWSTR          lpszPassword;
  DWORD           dwPasswordLength;
  LPWSTR          lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPWSTR          lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTS, *LPURL_COMPONENTS;

Membres

dwStructSize

Taille de cette structure, en octets. Utilisé pour la vérification de version. La taille de cette structure doit être définie pour initialiser cette structure correctement.

lpszScheme

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

dwSchemeLength

Longueur du nom du schéma, en caractères.

nScheme

Schéma de protocole Internet. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
INTERNET_SCHEME_HTTP 1	Le schéma Internet est le protocole HTTP. Pour plus d’informations, consultez RFC 2616 .
INTERNET_SCHEME_HTTPS 2	Le schéma Internet, HTTPS, est un protocole HTTP qui utilise la sémantique de transaction sécurisée.

lpszHostName

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

dwHostNameLength

Longueur du nom d’hôte, en caractères.

nPort

Numéro de port.

lpszUserName

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

dwUserNameLength

Longueur du nom d’utilisateur, en caractères.

lpszPassword

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

dwPasswordLength

Longueur du mot de passe, en caractères.

lpszUrlPath

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

dwUrlPathLength

Longueur du chemin d’URL, en caractères.

lpszExtraInfo

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

dwExtraInfoLength

Valeur entière longue non signée qui contient la longueur des informations supplémentaires, en caractères.

Remarques

Pour la fonction WinHttpCrackUrl , si un membre pointeur et son membre de longueur correspondant sont tous deux zéro, ce composant de l’URL n’est pas retourné. Si le membre pointeur a la valeur NULL , mais que le membre de longueur n’est pas égal à zéro, les membres de pointeur et de longueur sont retournés. Si le pointeur et les membres de longueur correspondants sont différents de zéro, le membre pointeur pointe vers une mémoire tampon où le composant est copié. Toutes les séquences d’échappement peuvent être supprimées d’un composant, en fonction du paramètre dwFlags de WinHttpCrackUrl.

Pour la fonction WinHttpCreateUrl , les membres du pointeur doivent être NULL si le composant de l’URL n’est pas requis. Si le membre de longueur correspondant est égal à zéro, le membre pointeur est le pointeur vers 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 Pour Windows XP et Windows 2000, consultez la section Conditions requises pour l’exécution de la page de démarrage WinHttp.

Configuration requise


Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
En-tête	winhttp.h
Composant redistribuable	WinHTTP 5.0 et Internet Explorer 5.01 ou version ultérieure sur Windows XP et Windows 2000.

Voir aussi

WinHTTP Versions

Partager via