InternetCheckConnectionW-Funktion (wininet.h)

Artikel
08/27/2023

[InternetCheckConnection ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen NetworkInformation.GetInternetConnectionProfile oder die NLM-Schnittstellen. ]

Ermöglicht einer Anwendung zu überprüfen, ob eine Verbindung mit dem Internet hergestellt werden kann.

Syntax

BOOL InternetCheckConnectionW(
  [in] LPCWSTR lpszUrl,
  [in] DWORD   dwFlags,
  [in] DWORD   dwReserved
);

Parameter

[in] lpszUrl

Zeiger auf eine NULL-beendete Zeichenfolge, die die URL angibt, die zum Überprüfen der Verbindung verwendet werden soll. Dieser Wert kann NULL sein.

[in] dwFlags

Optionen. FLAG_ICC_FORCE_CONNECTION ist das einzige Flag, das derzeit verfügbar ist. Wenn dieses Flag festgelegt ist, erzwingt es eine Verbindung. Es wird versucht, eine Socketsverbindung in der folgenden Reihenfolge herzustellen:

Wenn lpszUrl nicht NULL ist, wird der Hostwert daraus extrahiert und zum Pingen dieses spezifischen Hosts verwendet.
Wenn lpszUrlNULL ist und es einen Eintrag in der internen Serverdatenbank für den nächstgelegenen Server gibt, wird der Hostwert aus dem Eintrag extrahiert und zum Pingen dieses Servers verwendet.

[in] dwReserved

Dieser Parameter ist reserviert und muss 0 sein.

Rückgabewert

Gibt TRUE zurück, wenn eine Verbindung erfolgreich hergestellt wurde, oder andernfalls FALSE . Verwenden Sie GetLastError , um den Fehlercode abzurufen. ERROR_NOT_CONNECTED wird von GetLastError zurückgegeben, wenn keine Verbindung hergestellt werden kann oder die Sockets-Datenbank bedingungslos offline ist.

Hinweise

InternetCheckConnection ist veraltet. InternetCheckConnection funktioniert nicht in Umgebungen, in denen ein Webproxyserver für den Zugriff auf das Internet verwendet wird. Verwenden Sie abhängig von der Umgebung NetworkInformation.GetInternetConnectionProfile oder die NLM-Schnittstellen , um stattdessen nach Internetzugriff zu suchen.

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 wininet.h-Header definiert InternetCheckConnection 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

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

Aktivieren der Internetfunktionalität

WinINet-Funktionen

Share via