InternetDialW-Funktion (winineti.h)

Artikel
03/04/2024

Initiiert eine Verbindung mit dem Internet über ein Modem.

Syntax

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

Parameter

[in] hwndParent

Handle für das übergeordnete Fenster.

[in] lpszConnectoid

Zeiger auf eine NULL-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, stellt die Funktion eine Verbindung mit der automatischen Verbindung her.

[in] dwFlags

Optionen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
INTERNET_AUTODIAL_FORCE_ONLINE	Erzwingt eine Onlineverbindung.
INTERNET_AUTODIAL_FORCE_UNATTENDED	Erzwingt eine unbeaufsichtigte Internet-Einwahl. Wenn ein Benutzereingriff erforderlich ist, schlägt die Funktion fehl.
INTERNET_DIAL_FORCE_PROMPT	Ignoriert die Einstellung "Automatisch wählen" und erzwingt die Anzeige der Benutzeroberfläche für Wählvorgänge.
INTERNET_DIAL_UNATTENDED	Stellt über ein Modem eine Verbindung mit dem Internet her, ohne dass nach Möglichkeit eine Benutzeroberfläche angezeigt wird. Andernfalls wartet die Funktion auf die Benutzereingabe.
INTERNET_DIAL_SHOW_OFFLINE	Zeigt die Schaltfläche Offline arbeiten anstelle der Schaltfläche Abbrechen in der Benutzeroberfläche für Wählzeichen an.

[out] lpdwConnection

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

[in] dwReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen Fehlerwert zurück. Der Fehlercode kann einer der folgenden Werte sein.

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

Hinweise

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 , um eine DFÜ-Verbindung herzustellen. WinINet unterstützt die in der RasDialDlg-Funktion dokumentierte Funktionalität.

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

Hinweis

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 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	winineti.h (einschließlich Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Herstellen einer DFÜ-Verbindung mit dem Internet

WinINet-Funktionen

Share via