InternetCheckConnectionA-Funktion (wininet.h)

Artikel
11/20/2024

[InternetCheckConnection steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen NetworkInformation.GetInternetConnectionProfile oder die NLM-Schnittstellen. ]

Ermöglicht einer Anwendung zu überprüfen, ob eine Internetverbindung hergestellt werden kann.

Syntax

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

Parameter

[in] lpszUrl

Zeigen Sie auf eine NULL--terminated-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 diese Kennzeichnung festgelegt ist, erzwingt sie eine Verbindung. Es wird versucht, eine Socketverbindung in der folgenden Reihenfolge herzustellen:

Wenn lpszUrl- nichtNULL-ist, wird der Hostwert daraus extrahiert und zum Ping dieses bestimmten Hosts verwendet.
Wenn lpszUrlNULL- ist und ein Eintrag in der internen Serverdatenbank für den nächsten Server vorhanden ist, 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 FALSE andernfalls. Verwenden Sie GetLastError-, um den Fehlercode abzurufen. ERROR_NOT_CONNECTED wird von GetLastError zurückgegeben, wenn keine Verbindung hergestellt werden kann oder die Socketsdatenbank bedingungslos offline ist.

Bemerkungen

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

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 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 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-	wininet.h
Library	Wininet.lib
DLL-	Wininet.dll

Siehe auch

Aktivieren von Internetfunktionen

WinINet-Funktionen

Freigeben über