Freigeben über


InternetGoOnlineA-Funktion (winineti.h)

Fordert den Benutzer zur Berechtigung auf, eine 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-beendete 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, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. 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.

Hinweise

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

Hinweis

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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winineti.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