InternetCreateUrlA-Funktion (wininet.h)

Artikel
08/27/2023

Erstellt eine URL aus den Komponententeilen.

Syntax

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

Parameter

[in] lpUrlComponents

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

[in] dwFlags

Steuert den Betrieb dieser Funktion. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
ICU_ESCAPE	Konvertiert alle unsicheren Zeichen in die entsprechenden Escapesequenzen in der Pfadzeichenfolge, auf die vom lpszUrlPath-Member verwiesen wird, und in lpszExtraInfo die Zeichenfolge für zusätzliche Informationen, auf die der Member der URL_COMPONENTS Struktur verweist, auf die der parameter lpUrlComponents verweist. Die Unicode-Version von InternetCreateUrl versucht zunächst, mithilfe der Systemcodepage zu konvertieren. Wenn dies fehlschlägt, greift er 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 vom lpszUrlPath-Member verwiesen wird, und in lpszExtraInfo die Zeichenfolge für zusätzliche Informationen, auf die der Member der URL_COMPONENTS Struktur verweist, auf die der parameter lpUrlComponents verweist.

Die Unicode-Version von InternetCreateUrl versucht zunächst, mithilfe der Systemcodepage zu konvertieren. Wenn dies fehlschlägt, greift er auf UTF-8 zurück.

ICU_USERNAME

Veraltet – ignoriert.

[out] lpszUrl

Zeiger auf einen Puffer, der die URL empfängt.

[in, out] lpdwUrlLength

Zeiger auf eine Variable, die die Größe des URL lpszUrl-Puffers in TCHARs angibt. Wenn die Funktion zurückgibt, empfängt dieser Parameter die Größe der URL-Zeichenfolge, mit Ausnahme des NULL-Abschlusszeichens. Wenn GetLastError ERROR_INSUFFICIENT_BUFFER zurückgibt, empfängt dieser Parameter die Anzahl von Bytes, die erforderlich sind, um die erstellte URL zu enthalten.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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

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 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Behandeln von Uniform Resource Locators

WinINet-Funktionen

Share via