RASDIALFUNC-Rückruffunktion (ras.h)

Artikel
03/01/2024

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.

Hinweis Der Einfachheit halber kann RasHangUp innerhalb einer RasDialFunc-Rückruffunktion aufgerufen werden. Ein Großteil der Verarbeitung des Aufhängens erfolgt jedoch, nachdem die RasDialFunc-Rückruffunktion zurückgegeben wurde.

HinweisRasDialFunc ist ein Platzhalter für den anwendungsdefinierten oder bibliotheksdefinierten Funktionsnamen.

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