RASDIALFUNC2 Rückruffunktion (ras.h)
Eine RasDialFunc2-Rückruffunktion wird von der RasDial-Funktion aufgerufen, wenn während eines RAS-Verbindungsvorgangs ein Zustandswechsel auftritt. Eine RasDialFunc2-Funktion ähnelt der RasDialFunc1-Rückruffunktion , mit der Ausnahme, dass sie zusätzliche Informationen für Multilinkverbindungen bereitstellt.
Syntax
RASDIALFUNC2 Rasdialfunc2;
DWORD Rasdialfunc2(
ULONG_PTR unnamedParam1,
DWORD unnamedParam2,
HRASCONN unnamedParam3,
UINT unnamedParam4,
tagRASCONNSTATE unnamedParam5,
DWORD unnamedParam6,
DWORD unnamedParam7
)
{...}
Parameter
unnamedParam1
unnamedParam2
unnamedParam3
unnamedParam4
unnamedParam5
unnamedParam6
unnamedParam7
Rückgabewert
Wenn die RasDialFunc2-Funktion einen Wert ungleich null zurückgibt, sendet RasDial weiterhin Rückrufbenachrichtigungen.
Wenn die RasDialFunc2-Funktion null zurückgibt, beendet RasDial das Senden von Rückrufbenachrichtigungen für alle Untergeordneten.
Hinweise
Ein RasDial-Verbindungsvorgang wird während eines Aufrufs einer RasDialFunc2-Rückruffunktion angehalten. Aus diesem Grund wird die RasDialFunc2-Implementierung in der Regel so schnell wie möglich zurückgegeben. Es gibt zwei Ausnahmen von dieser Regel. Asynchrone (langsame) Geräte wie Modems weisen häufig Timeoutperioden auf, die nicht in Millisekunden, sondern in Sekunden gemessen werden. Eine langsame Rückkehr von einer RasDialFunc2-Funktion ist im Allgemeinen kein Problem. Die Eingabeaufforderungsrückgabeanforderung gilt auch nicht, wenn dwError ungleich null ist, was angibt, dass ein Fehler aufgetreten ist. Es ist z. B. sicher, ein Fehlerdialogfeld zu erstellen und auf die Benutzereingabe zu warten.
Die RasDialFunc2-Implementierung sollte nicht von der Reihenfolge oder dem Vorkommen bestimmter RASCONNSTATE-Verbindungszuständen abhängen, da dies je nach Plattform variieren kann.
Rufen Sie die RasDial-Funktion nicht aus einer RasDialFunc2-Rückruffunktion auf. Rufen Sie die Funktionen RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString und RasHangUp innerhalb der Rückruffunktion auf. Beispielsweise wäre der Aufruf von RasGetConnectStatus aus einer Rückruffunktion hilfreich, um den Namen und Typ des verbindenden Geräts zu bestimmen.
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 | ras.h |