RASDIALFUNC2 funzione di callback (ras.h)

Articolo
08/25/2023

Una funzione di callback RasDialFunc2 viene chiamata dalla funzione RasDial quando si verifica una modifica dello stato durante un processo di connessione di accesso remoto. Una funzione RasDialFunc2 è simile alla funzione di callback RasDialFunc1 , ad eccezione del fatto che fornisce informazioni aggiuntive per le connessioni multilink.

Sintassi

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

Parametri

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

Valore restituito

Se la funzione RasDialFunc2 restituisce un valore diverso da zero, RasDial continua a inviare notifiche di callback.

Se la funzione RasDialFunc2 restituisce zero, RasDial interrompe l'invio di notifiche di callback per tutte le sottoinsieme.

Commenti

Un'operazione di connessione RasDial viene sospesa durante una chiamata a una funzione di callback RasDialFunc2 . Per questo motivo, l'implementazione rasDialFunc2 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 RasDialFunc2 non è in genere 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 rasDialFunc2 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 RasDialFunc2 . 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 RasDialFunc2 . Tuttavia, gran parte dell'elaborazione di blocco si verifica dopo che la funzione di callback RasDialFunc2 è stata restituita.

NotaRasDialFunc2 è 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