InternetDialA-Funktion (winineti.h)
Initiiert eine Verbindung mit dem Internet über ein Modem.
Syntax
DWORD InternetDialA(
[in] HWND hwndParent,
[in] LPSTR 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 |
---|---|
|
Erzwingt eine Onlineverbindung. |
|
Erzwingt eine unbeaufsichtigte Internet-Einwahl. Wenn ein Benutzereingriff erforderlich ist, schlägt die Funktion fehl. |
|
Ignoriert die Einstellung "Automatisch wählen" und erzwingt die Anzeige der Benutzeroberfläche für Wählvorgänge. |
|
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. |
|
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 |
---|---|
|
Einer oder mehrere der Parameter sind falsch. |
|
Es liegt ein Problem mit der DFÜ-Verbindung vor. |
|
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
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
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für