struttura URL_COMPONENTSA (wininet.h)

Articolo
11/20/2024

Contiene le parti costitutive di un URL. Questa struttura viene usata con le funzioni di 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;

Membri

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 che contiene 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.

Osservazioni

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 di lunghezza non è zero, vengono restituiti sia il puntatore che i membri di lunghezza. Se i membri puntatore e 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 è necessario. Se il membro di lunghezza corrispondente è zero, il membro del puntatore è l'indirizzo di una stringa con terminazione zero. Se il membro di lunghezza 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 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	wininet.h

Vedere anche

InternetCrackUrl

InternetCreateUrl

Condividi tramite