InternetCheckConnectionA-Funktion (wininet.h)
[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 InternetCheckConnectionA(
[in] LPCSTR 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
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
| 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 |