Función InternetGetConnectedStateExA (winineti.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 InternetGetConnectedStateExA(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
        DWORD   cchNameLen,
  [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 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.

[out] lpszConnectionName

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

cchNameLen

TBD

[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 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).

 

Nota

El encabezado winineti.h define InternetGetConnectedStateEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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	winineti.h (incluya 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