RASDIALFUNC1 funzione di callback (ras.h)

Articolo
03/15/2023

Una funzione RasDialFunc1 viene chiamata dalla funzione RasDial quando si verifica una modifica dello stato durante un processo di connessione di accesso remoto. Una funzione RasDialFunc1 è paragonabile a una funzione RasDialFunc , ma è migliorata dall'aggiunta di due parametri: un handle alla connessione RAS e un codice di errore esteso.

Sintassi

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Parametri

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

Valore restituito

nessuno

Osservazioni

Un'operazione di connessione RasDial viene sospesa durante una chiamata a una funzione di callback RasDialFunc1 . Per questo motivo, l'implementazione rasDialFunc1 restituisce in genere il più rapidamente possibile. Esistono due eccezioni a tale regola. I dispositivi asincroni (lenti) come i modem spesso hanno periodi di timeout misurati in secondi anziché millisecondi; un ritorno lento da una funzione RasDialFunc1 non è in genere un problema. Il requisito di richiesta restituito non si applica anche quando dwError è diverso da zero, a indicare che si è verificato un errore. È sicuro, ad esempio, inserire una finestra di dialogo di errore e attendere l'input dell'utente.

L'implementazione rasDialFunc1 non deve dipendere dall'ordine o dall'occorrenza di determinati stati di connessione RASCONNSTATE , perché ciò può variare tra le piattaforme.

Non chiamare la funzione RasDial dall'interno di una funzione di callback RasDialFunc1 . Chiamare le funzioni RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString e RasHangUp dall'interno della funzione di callback. Ad esempio, chiamare RasGetConnectStatus dall'interno di una funzione di callback sarebbe utile per determinare il nome e il tipo del dispositivo che si connette.

Si noti che, per praticità, RasHangUp può essere chiamato dall'interno di una funzione di callback RasDialFunc1 . Tuttavia, gran parte dell'elaborazione di hang-up si verifica dopo la restituzione della funzione di callback RasDialFunc1 .

RasDialFunc1 è un segnaposto per il nome della funzione definita dall'applicazione o definita dalla libreria.

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