InternetGoOnlineA-Funktion (wininet.h)

Artikel
03/06/2024

Fordert den Benutzer zur Berechtigung auf, die Verbindung mit einer URL zu initiieren.

Syntax

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

Parameter

[in] lpszURL

Zeiger auf eine NULL-endende Zeichenfolge, die die URL der Website für die Verbindung angibt.

[in] hwndParent

Handle für das übergeordnete Fenster.

[in] dwFlags

Dieser Parameter kann null oder das folgende Flag sein.

Wert	Bedeutung
INTERNET_GOONLINE_REFRESH	Dieses Flag 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 einer der Parameter ist falsch. Der dwFlags-Parameter enthält einen anderen Wert als Null oder INTERNET_GOONLINE_REFRESH.

Hinweise

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 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
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 (einschließlich Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Herstellen einer DFÜ-Verbindung mit dem Internet

WinINet-Funktionen

Share via