RASDIALFUNC-Rückruffunktion (ras.h)
Die RasDialFunc-Rückruffunktion wird von der RasDial-Funktion aufgerufen, wenn während eines RAS-Verbindungsvorgangs eine Zustandsänderung auftritt.
Syntax
RASDIALFUNC Rasdialfunc;
void Rasdialfunc(
UINT unnamedParam1,
tagRASCONNSTATE unnamedParam2,
DWORD unnamedParam3
)
{...}
Parameter
unnamedParam1
unnamedParam2
unnamedParam3
Rückgabewert
Keine
Bemerkungen
Ein RasDial-Verbindungsvorgang wird während eines Aufrufs einer RasDialFunc-Rückruffunktion angehalten. Aus diesem Grund sollte die RasDialFunc-Implementierung in der Regel so schnell wie möglich zurückkehren. Es gibt zwei Ausnahmen von dieser Regel. Asynchrone (langsame) Geräte wie Modems weisen häufig Timeoutperioden auf, die in Sekunden und nicht in Millisekunden gemessen werden. eine langsame Rückkehr von einer RasDialFunc-Funktion ist in der Regel kein Problem. Die Eingabeaufforderungsrückgabeanforderung gilt auch nicht, wenn dwError nonzero ist, was angibt, dass ein Fehler aufgetreten ist. Es ist beispielsweise sicher, ein Fehlerdialogfeld zu erstellen und auf die Benutzereingabe zu warten.
Die RasDialFunc-Implementierung sollte nicht von der Reihenfolge oder dem Vorkommen bestimmter RASCONNSTATE-Verbindungszustände abhängen, da dies je nach Plattform variieren kann.
Rufen Sie die RasDial-Funktion nicht aus einer RasDialFunc-Rückruffunktion auf. Rufen Sie die Funktionen RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString und RasHangUp innerhalb der Rückruffunktion auf. Beispielsweise wäre das Aufrufen von RasGetConnectStatus innerhalb einer Rückruffunktion nützlich, um den Namen und Den 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 |