InternetGoOnlineA-Funktion (winineti.h)

Artikel
11/20/2024

Fordert den Benutzer auf, die Berechtigung zum Initiieren der Verbindung mit einer URL zu erhalten.

Syntax

BOOL InternetGoOnlineA(
  [in] LPCSTR lpszURL,
  [in] HWND   hwndParent,
  [in] DWORD  dwFlags
);

Parameter

[in] lpszURL

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die URL der Website für die Verbindung angibt.

[in] hwndParent

Behandeln sie das übergeordnete Fenster.

[in] dwFlags

Dieser Parameter kann null oder das folgende Flag sein.

Wert	Bedeutung
INTERNET_GOONLINE_REFRESH	Dieses Kennzeichen wird nicht verwendet.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE-zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE-zurückgegeben. Anwendungen können GetLastError- aufrufen, um den Fehlercode abzurufen.

Wenn die Funktionen fehlschlagen, kann der folgende Fehlercode zurückgegeben werden:

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens ein Parameter ist falsch. Der dwFlags Parameter enthält einen anderen Wert als Null oder INTERNET_GOONLINE_REFRESH.

Bemerkungen

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 winineti.h-Header definiert InternetGoOnline 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-	winineti.h (include Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Library	Wininet.lib
DLL-	Wininet.dll

Siehe auch

Einrichten einer DFÜ-Verbindung mit dem Internet

WinINet-Funktionen

Freigeben über