InternetAutodial-Funktion (wininet.h)

Artikel
08/27/2023

Bewirkt, dass das Modem automatisch die Standard-Internetverbindung wählt.

Syntax

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

Parameter

[in] dwFlags

Steuert diesen Vorgang. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
INTERNET_AUTODIAL_FAILIFSECURITYCHECK 0x04	Führt dazu, dass InternetAutodial fehlschlägt , wenn die Datei- und Druckerfreigabe für Windows 95 oder höher deaktiviert ist. Windows Server 2008 und Windows Vista: Dieses Flag ist veraltet.
INTERNET_AUTODIAL_FORCE_ONLINE 0x01	Erzwingt eine Online-Internetverbindung.
INTERNET_AUTODIAL_FORCE_UNATTENDED 0x02	Erzwingt eine unbeaufsichtigte Internet-Einwahl.
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT 0x08	Bewirkt , dass InternetAutodial die Modemverbindung wählt, auch wenn eine Netzwerkverbindung mit dem Internet besteht.

[in] hwndParent

Handle für das übergeordnete Fenster.

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.

Hinweise

InternetAutodial unterstützt keine Doppelwählverbindungen, SmartCard-Authentifizierung oder Verbindungen, die eine registrierungsbasierte Zertifizierung erfordern.

Hinweis Ab Windows Vista und Windows Server 2008 verwenden die WinINet-DFÜ-Funktionen die RAS-Funktionen , um eine DFÜ-Verbindung herzustellen. WinINet unterstützt die in der RasDialDlg-Funktion dokumentierte Funktionalität.

InternetAutodial versucht nicht, sich zu wählen, wenn eine DFÜ-Verbindung auf dem System vorhanden ist. Wenn eine LAN-Verbindung vorhanden ist und InternetAutodial nicht zum Erzwingen der Wählverbindung konfiguriert ist (legen Sie die INTERNET_AUTODIAL_FORCE_ONLINE im dwFlags-Parameter fest), versucht InternetAutodial nicht, die Verbindung zu wählen, und gibt TRUE zurück.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

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).

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)
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Herstellen einer DFÜ-Verbindung mit dem Internet

WinINet-Funktionen

Freigeben über