RASADFUNCA-Rückruffunktion (ras.h)
Die RASADFunc--Funktion ist eine anwendungsdefinierte Rückruffunktion, die verwendet wird, um eine benutzerdefinierte Benutzeroberfläche für die Autodialing 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 Standard-Benutzeroberfläche für die Wählhilfe.
Bemerkungen
Wenn das System einen AutoDial-Vorgang für einen Telefonbucheintrag mit einem benutzerdefinierten AutoDial-Handler startet, ruft es den angegebenen RASADFuncauf. Die 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ählfunktion übernommen hat, oder FALSE-, damit das System die Wählfunktion ausführen kann.
Wenn die RASADFunc--Funktion den Wählvorgang ausführt, stellt sie eine eigene Benutzeroberfläche für die Wählfunktion dar und ruft die RasDial--Funktion auf, um die eigentliche Wählfunktion auszuführen. Die RASADFunc- gibt dann TRUE- zurück, um anzugeben, dass die Wählsteuerung übernommen wurde. Wenn der Wählvorgang abgeschlossen wurde, legen Sie die Variable fest, auf die vom lpdwRetCode Parameter verwiesen wird, um Erfolg oder Fehler anzugeben.
Die AutoDial-DLL muss sowohl eine RASADFUNCA- (ANSI) als auch eine RASADFUNCW- (Unicode)-Version 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. Der szAutodialDll Member gibt den Namen der DLL an, die den Handler enthält, und das szAutodialFunc Member gibt den exportierten Namen des Handlers an. Das szAutodialFunc Member darf 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.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | ras.h |
Siehe auch
übersicht über Ras(Remote Access Service)