URL_COMPONENTSA Struktur (wininet.h)

Artikel
11/20/2024

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;

Angehörige

dwStructSize

Größe dieser Struktur in Byte.

lpszScheme

Zeigen Sie auf eine Zeichenfolge, die den Schemanamen enthält.

dwSchemeLength

Größe des Schemanamens in TCHARs.

nScheme

INTERNET_SCHEME Wert, der das Internetprotokollschema angibt.

lpszHostName

Zeigen Sie auf eine Zeichenfolge, die den Hostnamen enthält.

dwHostNameLength

Größe des Hostnamens in TCHARs.

nPort

Konvertierte Portnummer.

lpszUserName

Zeigen Sie auf einen Zeichenfolgenwert, der den Benutzernamen enthält.

dwUserNameLength

Größe des Benutzernamens in TCHARs.

lpszPassword

Zeigen Sie auf eine Zeichenfolge, die das Kennwort enthält.

dwPasswordLength

Größe des Kennworts in TCHARs.

lpszUrlPath

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

dwUrlPathLength

Größe des URL-Pfads in TCHARs.

lpszExtraInfo

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

dwExtraInfoLength

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

Bemerkungen

Bei InternetCrackUrl-wird diese Komponente nicht zurückgegeben, wenn ein Zeigerelement und das entsprechende Längenelement null sind. Wenn das Zeigerelement NULL- ist, aber das Längenelement nicht null ist, werden sowohl die Zeiger- als auch die Längenmember zurückgegeben. Wenn sowohl Zeiger- als auch entsprechende Längenmember ungleich Null sind, zeigt das Zeigermember auf einen Puffer, in den die Komponente kopiert wird. Die Komponente kann je nach dwFlags Parameter von InternetCrackUrlnicht escaped sein.

Bei InternetCreateUrl-sollten die Zeigermber NULL- sein, wenn die Komponente nicht erforderlich ist. Wenn das entsprechende Längenelement null ist, ist das Zeigerelement die Adresse einer Zeichenfolge mit Nullen. Wenn das Längenelement nicht null ist, handelt es sich um die Zeichenfolgenlänge des entsprechenden Zeigerelements.

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

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	wininet.h

Siehe auch

InternetCrackUrl-

InternetCreateUrl-

Freigeben über