Funzione di callback RASDIALFUNC (ras.h)

Articolo
03/01/2024

La funzione di callback RasDialFunc viene chiamata dalla funzione RasDial quando si verifica una modifica dello stato durante un processo di connessione RAS.

Sintassi

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

Parametri

unnamedParam1

unnamedParam2

unnamedParam3

Valore restituito

nessuno

Osservazioni

Un'operazione di connessione RasDial viene sospesa durante una chiamata a una funzione di callback RasDialFunc . Per questo motivo, l'implementazione rasDialFunc dovrebbe in genere restituire 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; una restituzione lenta da una funzione RasDialFunc in genere non è un problema. Il requisito restituito del prompt non si applica anche quando dwError è diverso da zero, che indica che si è verificato un errore. È sicuro, ad esempio, inserire una finestra di dialogo di errore e attendere l'input dell'utente.

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

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

Nota Per praticità, RasHangUp può essere chiamato dall'interno di una funzione di callback RasDialFunc . Tuttavia, gran parte dell'elaborazione di blocco si verifica dopo che la funzione di callback RasDialFunc è stata restituita.

NotaRasDialFunc è un segnaposto per il nome di funzione definito dall'applicazione o 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