InternetDialW-Funktion (winineti.h)

Artikel
11/20/2024

Initiiert eine Verbindung mit dem Internet mithilfe eines Modems.

Syntax

DWORD InternetDialW(
  [in]  HWND      hwndParent,
  [in]  LPWSTR    lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

Parameter

[in] hwndParent

Behandeln sie das übergeordnete Fenster.

[in] lpszConnectoid

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Namen der zu verwendenden DFÜ-Verbindung angibt. Wenn dieser Parameter die leere Zeichenfolge ("") enthält, wählt der Benutzer die Verbindung aus. Wenn dieser Parameter NULL-ist, wird die Funktion mit der automatischen Verbindung verbunden.

[in] dwFlags

Optionen. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
INTERNET_AUTODIAL_FORCE_ONLINE	Erzwingt eine Onlineverbindung.
INTERNET_AUTODIAL_FORCE_UNATTENDED	Erzwingt ein unbeaufsichtigtes Internet-DFÜ. Wenn ein Benutzereingriff erforderlich ist, schlägt die Funktion fehl.
INTERNET_DIAL_FORCE_PROMPT	Ignoriert die Einstellung "Automatisches Wählen" und erzwingt die Anzeige der Wähl-Benutzeroberfläche.
INTERNET_DIAL_UNATTENDED	Stellt eine Verbindung mit dem Internet über ein Modem bereit, ohne eine Benutzeroberfläche anzuzeigen, falls möglich. Andernfalls wartet die Funktion auf die Benutzereingabe.
INTERNET_DIAL_SHOW_OFFLINE	Zeigt die Schaltfläche Offline- arbeiten anstelle der Schaltfläche Abbrechen auf der Benutzeroberfläche für die Wählhilfe an.

[out] lpdwConnection

Zeiger auf eine Variable, die die Verbindungsnummer angibt. Diese Zahl ist ein eindeutiger Bezeichner für die Verbindung, die in anderen Funktionen verwendet werden kann, z. B. InternetHangUp-.

[in] dwReserved

Dieser Parameter ist reserviert und muss NULL-sein.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn dies erfolgreich ist, oder einen anderen Fehlerwert. Der Fehlercode kann einer der folgenden Werte sein:

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens ein Parameter ist falsch.
ERROR_NO_CONNECTION	Es liegt ein Problem mit der DFÜ-Verbindung vor.
ERROR_USER_DISCONNECTION	Der Benutzer hat entweder auf die Schaltfläche Offline arbeiten oder auf Schaltfläche " abbrechen" im Dialogfeld "Internetverbindung" geklickt.

Bemerkungen

InternetDial- 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 zum Einrichten einer DFÜ-Verbindung. WinINet unterstützt die in der RasDialDlg-Funktion dokumentierte Funktionalität.

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

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 winineti.h-Header definiert InternetDial 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-	winineti.h (include Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Library	Wininet.lib
DLL-	Wininet.dll

Siehe auch

Einrichten einer DFÜ-Verbindung mit dem Internet

WinINet-Funktionen

Freigeben über