Funzione di callback RASADFUNCA (ras.h)

La funzione RASADFunc è una funzione di callback definita dall'applicazione usata per fornire un'interfaccia utente personalizzata per l'autodialing.

Sintassi

RASADFUNCA Rasadfunca;

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

Parametri

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Valore restituito

Se l'applicazione esegue l'operazione di composizione, restituire TRUE. Usare il parametro lpdwRetCode per indicare i risultati dell'operazione di composizione.

Se l'applicazione non esegue l'operazione di composizione, restituire FALSE. In questo caso, il sistema usa l'interfaccia utente predefinita per la composizione.

Commenti

Quando il sistema avvia un'operazione AutoDial per una voce di rubrica telefonica con un gestore autoDial personalizzato, chiama rasADFunc specificato. RASADFunc può avviare un thread per eseguire l'operazione di composizione personalizzata. La funzione RASADFunc restituisce TRUE per indicare che ha assunto la composizione o FALSE per consentire al sistema di eseguire la composizione.

Se la funzione RASADFunc esegue l'operazione di composizione, presenta la propria interfaccia utente per la composizione e chiama la funzione RasDial per eseguire la composizione effettiva. RASADFunc restituisce quindi TRUE per indicare che è stato eseguito il dialing. Al termine dell'operazione di composizione, impostare la variabile a cui punta il parametro lpdwRetCode per indicare l'esito positivo o negativo.

La DLL AutoDial deve fornire sia una versione RASADFUNCA (ANSI) sia una versione RASADFUNCW (Unicode) del gestore RASADFunc . Per abilitare un gestore automatico RASADFunc per una voce di rubrica telefonica, usare la struttura RASENTRY in una chiamata alla funzione RasSetEntryProperties . Il membro szAutodialDll specifica il nome della DLL contenente il gestore e il membro szAutodialFunc specifica il nome esportato del gestore. Il membro szAutodialFunc non deve includere il suffisso "A" o "W".

RASADFunc è un segnaposto per il nome della funzione definito dalla libreria. Il tipo RASADFUNC è un puntatore a una funzione RASADFunc .

Nota

L'intestazione ras.h definisce RASADFUNC come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ras.h

Vedi anche

RASENTRY

RasDial

Rassetentryproperties

Panoramica del servizio di accesso remoto (RAS)

Funzioni del Servizio di accesso remoto