Funzione RasConnectionNotificationA (ras.h)

  • Articolo

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 Significato
RASCN_Connection
 Se hrasconn è INVALID_HANDLE_VALUE, hEvent viene segnalato quando viene creata una connessione RAS.
RASCN_Disconnection
 hEvent viene segnalato quando la connessione hrasconn viene terminata. Se hrasconn è una connessione multilink, l'evento viene segnalato quando tutte le sotto voci vengono disconnesse. Se hrasconn è INVALID_HANDLE_VALUE, l'evento viene segnalato quando viene terminata una connessione RAS.
RASCN_BandwidthAdded
 Windows NT: Se hrasconn è un handle per una connessione multilink combinata, hEvent viene segnalato quando viene connessa una sottoentria.
RASCN_BandwidthRemoved
 Windows NT: Se hrasconn è un handle per una connessione multilink combinata, hEvent viene segnalato quando viene disconnessa una sottoentria.

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

Vedi anche

CreateEvent

RasEnumConnections

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto