Compartir a través de

Función InternetGetConnectedState (wininet.h)

  • Artículo
Nota No se recomienda usar esta API, use el método INetworkListManager::GetConnectivity en su lugar.
 
Recupera el estado conectado del sistema local.

Sintaxis

BOOL InternetGetConnectedState(
  [out] LPDWORD lpdwFlags,
  [in]  DWORD   dwReserved
);

Parámetros

[out] lpdwFlags

Puntero a una variable que recibe la descripción de la conexión. Este parámetro puede devolver una marca válida incluso cuando la función devuelve FALSE. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
INTERNET_CONNECTION_CONFIGURED
0x40
 El sistema local tiene una conexión válida a Internet, pero puede o no estar conectado actualmente.
INTERNET_CONNECTION_LAN
0x02
 El sistema local usa una red de área local para conectarse a Internet.
INTERNET_CONNECTION_MODEM
0x01
 El sistema local usa un módem para conectarse a Internet.
INTERNET_CONNECTION_MODEM_BUSY
0x08
 Ya no se usa.
INTERNET_CONNECTION_OFFLINE
0x20
 El sistema local está en modo sin conexión.
INTERNET_CONNECTION_PROXY
0x04
 El sistema local usa un servidor proxy para conectarse a Internet.
INTERNET_RAS_INSTALLED
0x10
 El sistema local tiene RAS instalado.

[in] dwReserved

Este parámetro está reservado y debe ser 0.

Valor devuelto

Devuelve TRUE si hay un módem activo o una conexión a Internet LAN, o FALSE si no hay ninguna conexión a Internet, o si todas las conexiones a Internet posibles no están activas actualmente. Para obtener más información, vea la sección Comentarios.

Cuando InternetGetConnectedState devuelve FALSE, la aplicación puede llamar a GetLastError para recuperar el código de error.

Comentarios

Un valor devuelto de TRUE de InternetGetConnectedState indica que hay disponible al menos una conexión a Internet. No garantiza que se pueda establecer una conexión a un host específico. Las aplicaciones siempre deben comprobar si se devuelven errores de llamadas API que se conectan a un servidor. Se puede llamar a InternetCheckConnection para determinar si se puede establecer una conexión a un destino específico.

Un valor devuelto de TRUE indica que la conexión del módem está activa o que una conexión LAN está activa y un proxy está configurado correctamente para la LAN. Un valor devuelto de FALSE indica que ni el módem ni la LAN están conectados. Si se devuelve FALSE , se puede establecer la marca INTERNET_CONNECTION_CONFIGURED para indicar que autodial está configurado como "siempre marcado", pero no está activo actualmente. Si no se configura el autodial, la función devuelve FALSE.

Al igual que todos los demás aspectos de la API de WinINet, esta función no se puede llamar de forma segura desde DllMain ni desde los constructores y destructores de objetos globales.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use los servicios HTTP de Microsoft Windows (WinHTTP).
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wininet.h (incluya Wininet.h)
Library Wininet.lib
Archivo DLL Wininet.dll

Consulte también

Establecimiento de una conexión de acceso telefónico a Internet

Funciones de WinINet