InternetCreateUrlW-Funktion (wininet.h)

Artikel
11/20/2024

Erstellt eine URL aus den Komponententeilen.

Syntax

BOOL InternetCreateUrlW(
  [in]      LPURL_COMPONENTSW lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPWSTR            lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

Parameter

[in] lpUrlComponents

Zeigen Sie auf eine URL_COMPONENTS Struktur, die die Komponenten enthält, aus denen die URL erstellt werden soll.

[in] dwFlags

Steuert den Vorgang dieser Funktion. Dieser Parameter kann einen oder mehrere der folgenden Werte sein.

Wert	Bedeutung
ICU_ESCAPE	Konvertiert alle unsicheren Zeichen in die entsprechenden Escapesequenzen in der Pfadzeichenfolge, auf die durch das lpszUrlPath-element und in lpszExtraInfo der zusätzlichen Informationszeichenfolge, die durch das Element der URL_COMPONENTS Struktur verweist, auf das durch den lpUrlComponents Parameter verwiesen wird. Die Unicode-Version von InternetCreateUrl versucht zuerst, mithilfe der Systemcodepage zu konvertieren. Wenn dies fehlschlägt, fällt sie auf UTF-8 zurück.
ICU_USERNAME	Veraltet – ignoriert.

Wert

Bedeutung

ICU_ESCAPE

Konvertiert alle unsicheren Zeichen in die entsprechenden Escapesequenzen in der Pfadzeichenfolge, auf die durch das lpszUrlPath-element und in lpszExtraInfo der zusätzlichen Informationszeichenfolge, die durch das Element der URL_COMPONENTS Struktur verweist, auf das durch den lpUrlComponents Parameter verwiesen wird.

Die Unicode-Version von InternetCreateUrl versucht zuerst, mithilfe der Systemcodepage zu konvertieren. Wenn dies fehlschlägt, fällt sie auf UTF-8 zurück.

ICU_USERNAME

Veraltet – ignoriert.

[out] lpszUrl

Zeigen Sie auf einen Puffer, der die URL empfängt.

[in, out] lpdwUrlLength

Zeiger auf eine Variable, die die Größe der URL lpszUrl Puffer in TCHARs-angibt. Wenn die Funktion zurückgegeben wird, empfängt dieser Parameter die Größe der URL-Zeichenfolge, mit Ausnahme des NULL-Terminators. Wenn GetLastError- ERROR_INSUFFICIENT_BUFFER zurückgibt, empfängt dieser Parameter die Anzahl der Bytes, die zum Halten der erstellten URL erforderlich sind.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist, oder FALSE andernfalls. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Wenn Sie das Schema in der URL_COMPONENTS Struktur angeben, das an lpUrlComponentsübergeben wird, wenn lpszScheme nicht NULL ist, wird es für das Schema verwendet. Wenn lpszScheme- NULL ist, kann das Schema mithilfe der INTERNET_SCHEME-Aufzählung angegeben werden, indem nScheme- auf die erforderliche INTERNET_SCHEME oder INTERNET_SCHEME_DEFAULTfestgelegt wird.

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 InternetCreateUrl 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]
Zielplattform-	Fenster
Header-	wininet.h
Library	Wininet.lib
DLL-	Wininet.dll

Siehe auch

Behandeln von Uniform Resource Locators

WinINet-Funktionen

Freigeben über