Funzione RasConnectionNotificationA (ras.h)
La funzione RasConnectionNotification specifica un oggetto evento impostato dal sistema sullo stato segnalato quando viene creata o terminata una connessione RAS.
Sintassi
DWORD RasConnectionNotificationA(
[in] HRASCONN unnamedParam1,
[in] HANDLE unnamedParam2,
[in] DWORD unnamedParam3
);
Parametri
[in] unnamedParam1
Handle per la connessione RAS che riceve le notifiche. Può trattarsi di un handle restituito dalla funzione RasDial o RasEnumConnections . Se questo parametro è INVALID_HANDLE_VALUE, le notifiche vengono ricevute per tutte le connessioni RAS nel client locale.
[in] unnamedParam2
Specifica l'handle di un oggetto evento. Utilizzare la funzione CreateEvent per creare un oggetto evento.
[in] unnamedParam3
Specifica l'evento RAS che fa in modo che il sistema segnali l'oggetto evento specificato dal parametro hEvent . Questo parametro è una combinazione dei valori seguenti.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero da Routing e Remote Access Error Codes o Winerror.h.
Commenti
Per determinare quando viene segnalato l'oggetto evento, usare una delle funzioni di attesa.
Quando l'evento viene segnalato, usare altre funzioni RAS, ad esempio RasEnumConnections, per ottenere altre informazioni sulla connessione RAS creata o terminata.
Nota
L'intestazione ras.h definisce RasConnectionNotification 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |
Libreria | Rasapi32.lib |
DLL | Rasapi32.dll |