Funzione IsNetworkAlive (sensapi.h)

La funzione IsNetworkAlive determina se un sistema locale è connesso a una rete e identifica il tipo di connessione di rete, ad esempio lan, WAN o entrambi.

Sintassi

BOOL IsNetworkAlive(
  [out] LPDWORD lpdwFlags
);

Parametri

[out] lpdwFlags

Tipo di connessione di rete disponibile. Questo parametro può essere uno dei valori seguenti:

NETWORK_ALIVE_LAN

Il computer dispone di una o più schede LAN attive.

NETWORK_ALIVE_WAN

Il computer dispone di una o più connessioni RAS attive.

Valore restituito

Chiamare sempre GetLastError prima di controllare il codice restituito di questa funzione. Se l'ultimo errore non è 0, la funzione IsNetworkAlive ha avuto esito negativo e i valori TRUE e FALSE seguenti non si applicano.

Codice restituito	Descrizione
TRUE	Se l'ultimo errore è 0 e la funzione restituisce TRUE, SENS ha determinato che un sistema locale è connesso a una rete. Per informazioni sul tipo di connessione, vedere il parametro lpdwFlags .
FALSE	Se l'ultimo errore è 0 e la funzione restituisce FALSE, SENS ha determinato che non esiste alcuna connessione.

Commenti

A partire dalle applicazioni progettate per Windows Vista e Windows Server 2008, gli sviluppatori devono prendere in considerazione l'uso di Network List Manager invece di questa funzione.

Questa funzione può essere usata da un'applicazione per determinare se è presente o meno la connettività di rete prima di procedere con le operazioni di rete. Un tipo di servizio directory di applicazione, client di posta elettronica o browser Internet può adattarsi a vari tipi di connettività di rete. Ad esempio, un'operazione di stampa può essere posticipata fino a quando non è disponibile una connessione di rete.

Potrebbe non essere sempre pratico per un'applicazione chiamare IsNetworkAlive per determinare se un sistema locale è disconnesso da una LAN, perché IsNetworkAlive può essere lento e potrebbe essere necessario troppo tempo per la funzione per rilevare che un sistema locale è disconnesso. Tuttavia, IsNetworkAlive può sempre identificare una connettività WAN al momento.

Nota Questa funzione è disponibile solo per le connessioni TCP/IP.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sensapi.h
Libreria	Sensapi.lib
DLL	Sensapi.dll

Vedi anche

Informazioni sul servizio di notifica degli eventi di sistema

IsDestinationReachable