URL_COMPONENTSA-Struktur (wininet.h)

Artikel
08/27/2023

Enthält die Bestandteile einer URL. Diese Struktur wird mit den Funktionen InternetCrackUrl und InternetCreateUrl verwendet.

Syntax

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;

Member

dwStructSize

Größe dieser Struktur in Bytes.

lpszScheme

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

dwSchemeLength

Größe des Schemanamens in TCHARs.

nScheme

INTERNET_SCHEME Wert, der das Internetprotokollschema angibt.

lpszHostName

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

dwHostNameLength

Größe des Hostnamens in TCHARs.

nPort

Konvertierte Portnummer.

lpszUserName

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

dwUserNameLength

Größe des Benutzernamens in TCHARs.

lpszPassword

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

dwPasswordLength

Größe des Kennworts in TCHARs.

lpszUrlPath

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

dwUrlPathLength

Größe des URL-Pfads in TCHARs.

lpszExtraInfo

Zeiger auf eine Zeichenfolge, die die zusätzlichen Informationen enthält (z. B. "etwas" oder "#something").

dwExtraInfoLength

Größe der zusätzlichen Informationen in TCHARs.

Hinweise

Wenn für InternetCrackUrl ein Zeigermember und sein zugehöriges Längenelement beide null sind, wird diese Komponente nicht zurückgegeben. Wenn der Zeigermember NULL ist, aber das Längenelement nicht 0 ist, werden sowohl der Zeiger als auch die Längenmember zurückgegeben. Wenn sowohl zeiger als auch entsprechende Längenmember ungleich null sind, zeigt der Zeigermember auf einen Puffer, in den die Komponente kopiert wird. Die Komponente kann je nach dwFlags-Parameter von InternetCrackUrl nicht mit Escapezeichen versehen werden.

Für InternetCreateUrl sollten die Zeigermember NULL sein, wenn die Komponente nicht erforderlich ist. Wenn der entsprechende Längenmember 0 ist, ist der Zeigermember die Adresse einer Zeichenfolge, die mit Null beendet wird. Wenn das Längenelement nicht 0 (null) ist, ist dies die Zeichenfolgenlänge des entsprechenden Zeigerelements.

Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Hinweis

Der wininet.h-Header definiert URL_COMPONENTS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wininet.h

Weitere Informationen

InternetCrackUrl

InternetCreateUrl

Share via