struttura URL_COMPONENTSA (wininet.h)

Articolo
03/13/2024

Contiene le parti costitutive di un URL. Questa struttura viene utilizzata con le funzioni InternetCrackUrl e InternetCreateUrl .

Sintassi

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;

Members

dwStructSize

Dimensioni di questa struttura, in byte.

lpszScheme

Puntatore a una stringa contenente il nome dello schema.

dwSchemeLength

Dimensioni del nome dello schema, in TCHAR.

nScheme

INTERNET_SCHEME valore che indica lo schema del protocollo Internet.

lpszHostName

Puntatore a una stringa contenente il nome host.

dwHostNameLength

Dimensioni del nome host, in TCHAR.

nPort

Numero di porta convertito.

lpszUserName

Puntatore a un valore stringa contenente il nome utente.

dwUserNameLength

Dimensioni del nome utente, in TCHAR.

lpszPassword

Puntatore a una stringa contenente la password.

dwPasswordLength

Dimensioni della password, in TCHAR.

lpszUrlPath

Puntatore a una stringa contenente il percorso URL.

dwUrlPathLength

Dimensioni del percorso URL, in TCHAR.

lpszExtraInfo

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

dwExtraInfoLength

Dimensioni delle informazioni aggiuntive, in TCHAR.

Commenti

Per InternetCrackUrl, se un membro puntatore e il membro di lunghezza corrispondente sono entrambi zero, tale componente non viene restituito. Se il membro del puntatore è NULL ma il membro length non è zero, vengono restituiti sia il puntatore che i membri di lunghezza. Se sia il puntatore che i membri di lunghezza corrispondenti sono diversi da zero, il membro del puntatore punta a un buffer in cui viene copiato il componente. Il componente può essere senza escape, a seconda del parametro dwFlags di InternetCrackUrl.

Per InternetCreateUrl, i membri del puntatore devono essere NULL se il componente non è obbligatorio. Se il membro di lunghezza corrispondente è zero, il membro del puntatore è l'indirizzo di una stringa con terminazione zero. Se il membro length non è zero, corrisponde alla lunghezza della stringa del membro puntatore corrispondente.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).

Nota

L'intestazione wininet.h definisce URL_COMPONENTS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	wininet.h

Vedi anche

InternetCrackUrl

InternetCreateUrl

Condividi tramite