URL_COMPONENTS-Struktur (winhttp.h)

Artikel
08/27/2023

Die URL_COMPONENTS-Struktur enthält die Bestandteile einer URL. Diese Struktur wird mit den Funktionen WinHttpCrackUrl und WinHttpCreateUrl verwendet.

Syntax

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;

Member

dwStructSize

Größe dieser Struktur in Bytes. Wird für die Versionsprüfung verwendet. Die Größe dieser Struktur muss festgelegt werden, um diese Struktur ordnungsgemäß zu initialisieren.

lpszScheme

Zeiger auf einen Zeichenfolgenwert, der den Schemanamen enthält.

dwSchemeLength

Länge des Schemanamens in Zeichen.

nScheme

Internetprotokollschema. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
INTERNET_SCHEME_HTTP 1	Das Internetschema ist das HTTP-Protokoll. Weitere Informationen finden Sie unter RFC 2616 .
INTERNET_SCHEME_HTTPS 2	Das Internetschema HTTPS ist ein HTTP-Protokoll, das sichere Transaktionssemantik verwendet.

lpszHostName

Zeiger auf einen Zeichenfolgenwert, der den Hostnamen enthält.

dwHostNameLength

Länge des Hostnamens in Zeichen.

nPort

Portnummer

lpszUserName

Zeiger auf eine Zeichenfolge, die den Benutzernamen enthält.

dwUserNameLength

Länge des Benutzernamens in Zeichen.

lpszPassword

Zeiger auf eine Zeichenfolge, die das Kennwort enthält.

dwPasswordLength

Länge des Kennworts in Zeichen.

lpszUrlPath

Zeiger auf eine Zeichenfolge, die den URL-Pfad enthält.

dwUrlPathLength

Länge des URL-Pfads in Zeichen.

lpszExtraInfo

Zeiger auf einen Zeichenfolgenwert, der die zusätzlichen Informationen enthält, z. B. "something" oder "#something".

dwExtraInfoLength

Ganzzahlwert ohne Vorzeichen, der die Länge der zusätzlichen Informationen in Zeichen enthält.

Hinweise

Wenn für die WinHttpCrackUrl-Funktion ein Zeigerelement und sein zugehöriges Längenelement 0 sind, wird diese Komponente der URL nicht zurückgegeben. Wenn das Zeigerelement NULL ist, aber das Längenelement nicht 0 ist, werden sowohl die Zeiger- als auch die Längenmember zurückgegeben. Wenn sowohl zeiger als auch entsprechende Längenmember nicht zero sind, zeigt das Zeigermember auf einen Puffer, in den die Komponente kopiert wird. Abhängig vom dwFlags-Parameter von WinHttpCrackUrl können alle Escapesequenzen aus einer Komponente entfernt werden.

Für die WinHttpCreateUrl-Funktion sollten die Zeigermember NULL sein, wenn die Komponente der URL nicht erforderlich ist. Wenn das entsprechende Längenelement 0 ist, ist der Zeigermember der Zeiger auf eine Zeichenfolge, die mit null beendet ist. Wenn das Längenelement nicht 0 ist, ist dies die Zeichenfolgenlänge des entsprechenden Zeigerelements.

Hinweis Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHttp-Startseite .

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Kopfzeile	winhttp.h
Verteilbare Komponente	WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000.

Weitere Informationen

WinHTTP-Versionen

Freigeben über