RASDIALFUNC1 Rückruffunktion (ras.h)

Artikel
03/01/2024

Eine RasDialFunc1-Funktion wird von der RasDial-Funktion aufgerufen, wenn während eines RAS-Verbindungsvorgangs eine Zustandsänderung auftritt. Eine RasDialFunc1-Funktion ist vergleichbar mit einer RasDialFunc-Funktion , wird jedoch durch das Hinzufügen von zwei Parametern erweitert: ein Handle für die RAS-Verbindung und ein erweiterter Fehlercode.

Syntax

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Parameter

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

Rückgabewert

Keine

Bemerkungen

Ein RasDial-Verbindungsvorgang wird während eines Aufrufs einer RasDialFunc1-Rückruffunktion angehalten. Aus diesem Grund wird die RasDialFunc1-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 RasDialFunc1-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 RasDialFunc1-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 RasDialFunc1-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.

Beachten Sie, dass RasHangUp aus Gründen der Einfachheit innerhalb einer RasDialFunc1-Rückruffunktion aufgerufen werden kann. Ein Großteil der Verarbeitung erfolgt jedoch, nachdem die RasDialFunc1-Rückruffunktion zurückgegeben wurde.

RasDialFunc1 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