Función InternetGetConnectedStateEx (wininet.h)

Nota No se recomienda usar esta API, use el método INetworkListManager::GetConnectivity en su lugar.

 

Recupera el estado conectado de la conexión a Internet especificada.

Sintaxis

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [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 una combinación de los valores siguientes.

Value	Significado
INTERNET_CONNECTION_CONFIGURED 0x40	El sistema local tiene una conexión válida a Internet, pero es posible que esté conectado o no.
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.

[out] lpszConnectionName

Puntero a un valor de cadena que recibe el nombre de la conexión.

[in] dwNameLen

Tamaño de la cadena lpszConnectionName , en TCHAR.

[in] dwReserved

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

Valor devuelto

Devuelve TRUE si hay una conexión a Internet o FALSE si no hay 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 al menos una conexión a Internet disponible. 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 que 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 , la marca INTERNET_CONNECTION_CONFIGURED se puede establecer para indicar que el autodial está configurado en "siempre marcado", pero no está activo actualmente. Si no se configura 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 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 (incluye Wininet.h, Winineti.h, Wininet.h, Winineti.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