URL_COMPONENTS struttura (winhttp.h)

Articolo
08/27/2023

La struttura URL_COMPONENTS contiene le parti costitutive di un URL. Questa struttura viene usata con le funzioni WinHttpCrackUrl e WinHttpCreateUrl .

Sintassi

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;

Members

dwStructSize

Dimensioni di questa struttura, in byte. Usato per il controllo delle versioni. Le dimensioni di questa struttura devono essere impostate per inizializzare correttamente questa struttura.

lpszScheme

Puntatore a un valore stringa contenente il nome dello schema.

dwSchemeLength

Lunghezza del nome dello schema, in caratteri.

nScheme

Schema del protocollo Internet. Questo membro può essere uno dei valori seguenti.

Valore	Significato
INTERNET_SCHEME_HTTP 1	Lo schema Internet è il protocollo HTTP. Per altre informazioni, vedere RFC 2616 .
INTERNET_SCHEME_HTTPS 2	Lo schema Internet, HTTPS, è un protocollo HTTP che usa la semantica delle transazioni sicure.

lpszHostName

Puntatore a un valore stringa contenente il nome host.

dwHostNameLength

Lunghezza del nome host, in caratteri.

nPort

Numero porta.

lpszUserName

Puntatore a una stringa contenente il nome utente.

dwUserNameLength

Lunghezza del nome utente, in caratteri.

lpszPassword

Puntatore a una stringa contenente la password.

dwPasswordLength

Lunghezza della password, in caratteri.

lpszUrlPath

Puntatore a una stringa contenente il percorso URL.

dwUrlPathLength

Lunghezza del percorso URL, in caratteri.

lpszExtraInfo

Puntatore a un valore stringa contenente le informazioni aggiuntive, ad esempio ?qualcosa o #something.

dwExtraInfoLength

Valore intero lungo senza segno che contiene la lunghezza delle informazioni aggiuntive, in caratteri.

Commenti

Per la funzione WinHttpCrackUrl , se un membro puntatore e il membro di lunghezza corrispondente sono entrambi zero, tale componente dell'URL non viene restituito. Se il membro del puntatore è NULL , ma il membro di lunghezza non è zero, vengono restituiti sia il puntatore che i membri della lunghezza. Se sia il puntatore che i membri di lunghezza corrispondenti non sono zero, il membro puntatore punta a un buffer in cui viene copiato il componente. Tutte le sequenze di escape possono essere rimosse da un componente, a seconda del parametro dwFlags di WinHttpCrackUrl.

Per la funzione WinHttpCreateUrl , i membri del puntatore devono essere NULL se il componente dell'URL non è obbligatorio. Se il membro di lunghezza corrispondente è zero, il membro puntatore è il puntatore a una stringa con terminazione zero. Se il membro di lunghezza non è zero, è la lunghezza della stringa del membro puntatore corrispondente.

Nota Per Windows XP e Windows 2000, vedere la sezione Requisiti di runtime della pagina iniziale WinHttp.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Intestazione	winhttp.h
Componente ridistribuibile	WinHTTP 5.0 e Internet Explorer 5.01 o versione successiva in Windows XP e Windows 2000.

Vedi anche

Versioni WinHTTP

Condividi tramite