RASDIALFUNC2 Rückruffunktion (ras.h)

Artikel
03/04/2024

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.

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

HinweisRasDialFunc2 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