RASADFUNCA-Rückruffunktion (ras.h)

Artikel
08/25/2023

Die RASADFunc-Funktion ist eine anwendungsdefinierte Rückruffunktion, die verwendet wird, um eine benutzerdefinierte Benutzeroberfläche für die automatischeDialing bereitzustellen.

Syntax

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

Parameter

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Rückgabewert

Wenn die Anwendung den Wählvorgang ausführt, geben Sie TRUE zurück. Verwenden Sie den Parameter lpdwRetCode , um die Ergebnisse des Wählvorgangs anzugeben.

Wenn die Anwendung den Wählvorgang nicht ausführt, geben Sie FALSE zurück. In diesem Fall verwendet das System die Standardbenutzeroberfläche für die Wählfunktion.

Hinweise

Wenn das System einen AutoDial-Vorgang für einen Telefonbucheintrag mit einem benutzerdefinierten AutoDial-Handler startet, ruft es den angegebenen RASADFunc auf. RasADFunc kann einen Thread starten, um den benutzerdefinierten Wählvorgang auszuführen. Die RASADFunc-Funktion gibt TRUE zurück, um anzugeben, dass sie die Wählvorgänge übernommen hat, oder FALSE , damit das System die Wählvorgänge ausführen kann.

Wenn die RASADFunc-Funktion den Wählvorgang ausführt, stellt sie eine eigene Benutzeroberfläche zum Wählen bereit und ruft die RasDial-Funktion auf, um die eigentliche Wählverbindung durchzuführen. Der RASADFunc gibt dann TRUE zurück, um anzugeben, dass er die Wählfunktion übernommen hat. Legen Sie nach Abschluss des Wählvorgangs die Variable fest, auf die der lpdwRetCode-Parameter verweist, um Erfolg oder Fehler anzuzeigen.

Die AutoDial-DLL muss sowohl eine RASADFUNCA (ANSI) als auch eine RASADFUNCW -Version (Unicode) des RASADFunc-Handlers bereitstellen. Um einen RASADFunc AutoDial-Handler für einen Telefonbucheintrag zu aktivieren, verwenden Sie die RASENTRY-Struktur in einem Aufruf der RasSetEntryProperties-Funktion . Das szAutodialDll-Element gibt den Namen der DLL an, die den Handler enthält, und das szAutodialFunc-Element gibt den exportierten Namen des Handlers an. Das szAutodialFunc-Element sollte nicht das Suffix "A" oder "W" enthalten.

RASADFunc ist ein Platzhalter für den bibliotheksdefinierte Funktionsnamen. Der RASADFUNC-Typ ist ein Zeiger auf eine RASADFunc-Funktion .

Hinweis

Der ras.h-Header definiert RASADFUNC als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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