Función IsNetworkAlive (sensapi.h)
La función IsNetworkAlive determina si un sistema local está conectado a una red o no e identifica el tipo de conexión de red, por ejemplo, una LAN, WAN o ambas.
Sintaxis
BOOL IsNetworkAlive(
[out] LPDWORD lpdwFlags
);
Parámetros
[out] lpdwFlags
Tipo de conexión de red que está disponible. Este parámetro puede establecerse con uno de los siguientes valores:
NETWORK_ALIVE_LAN
El equipo tiene una o varias tarjetas LAN que están activas.
NETWORK_ALIVE_WAN
El equipo tiene una o varias conexiones RAS activas.
Valor devuelto
Llame siempre a GetLastError antes de comprobar el código de retorno de esta función. Si el último error no es 0, se ha producido un error en la función IsNetworkAlive y no se aplican los siguientes valores TRUE y FALSE .
| Código devuelto | Descripción |
|---|---|
|
Si el último error es 0 y la función devuelve TRUE, SENS ha determinado que un sistema local está conectado a una red.
Para obtener información sobre el tipo de conexión, consulte el parámetro lpdwFlags . |
|
Si el último error es 0 y la función devuelve FALSE, SENS ha determinado que no hay ninguna conexión. |
Comentarios
A partir de las aplicaciones diseñadas para Windows Vista y Windows Server 2008, los desarrolladores deben considerar el uso del Administrador de listas de redes en lugar de esta función.
Una aplicación puede usar esta función para determinar si hay conectividad de red o no antes de continuar con las operaciones de red. Un tipo de servicio de directorio de aplicación, cliente de correo electrónico o explorador de Internet puede adaptarse a varios tipos de conectividad de red. Por ejemplo, una operación de impresión se puede aplazar hasta que haya disponible una conexión de red.
Es posible que no siempre sea práctico que una aplicación llame a IsNetworkAlive para determinar si un sistema local está desconectado de una LAN, ya que IsNetworkAlive puede ser lento y puede tardar demasiado tiempo en detectar que un sistema local está desconectado. Sin embargo, IsNetworkAlive siempre puede identificar una conectividad WAN en ese momento.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | sensapi.h |
| Library | Sensapi.lib |
| Archivo DLL | Sensapi.dll |