URL_COMPONENTS struttura (winhttp.h)

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.

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.

Requisiti

Vedi anche

Versioni WinHTTP