Funzione di callback RASADFUNCW (ras.h)

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

Sintassi

RASADFUNCW Rasadfuncw;

BOOL Rasadfuncw(
  LPWSTR unnamedParam1,
  LPWSTR 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.

Osservazioni

Quando il sistema avvia un'operazione AutoDial per una voce di rubrica telefonica con un gestore AutoDial personalizzato, chiama il RASADFunc specificato. Il RASADFunc può avviare un thread per eseguire l'operazione di composizione personalizzata. La funzione RASADFunc restituisce TRUE per indicare che è stata presa 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. Il RASADFunc restituisce quindi TRUE per indicare che è stata presa la composizione. 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 RASADFunc AutoDial 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 di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione ras.h

Vedere anche

RASENTRY

RasDial

RasSetEntryProperties

Panoramica servizio di accesso remoto (RAS)

funzioni del servizio accesso remoto