Funzione RasConnectionNotificationA (ras.h)

Articolo
11/20/2024

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. Usare 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 viene terminata la connessione hrasconn. Se hrasconn è una connessione multilink, l'evento viene segnalato quando tutte le voci secondarie 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 sottosesistenza.
RASCN_BandwidthRemoved	Windows NT: Se hrasconn è un handle per una connessione multilink combinata, hEvent viene segnalato quando viene disconnessa una sottosesistenza.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero Codici di errore di routing e accesso remoto o Winerror.h.

Osservazioni

Per determinare quando viene segnalato l'oggetto evento, utilizzare 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ras.h
libreria	Rasapi32.lib
dll	Rasapi32.dll

Vedere anche

CreateEvent

RasEnumConnections

Panoramica servizio di accesso remoto (RAS)

funzioni del servizio accesso remoto

Condividi tramite