Función InternetGetConnectedStateExA (wininet.h)

Artículo
11/20/2024

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 siguientes valores.

Valor	Significado
INTERNET_CONNECTION_CONFIGURED 0x40	El sistema local tiene una conexión válida a Internet, pero podría estar o no 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 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 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.

Observaciones

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 las 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, se puede establecer la marca INTERNET_CONNECTION_CONFIGURED para indicar que autodial está configurado en "always dial", pero no está activo actualmente. Si no está configurado 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).

Nota

El encabezado wininet.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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wininet.h (incluya Wininet.h, Winineti.h, Wininet.h, Winineti.h)
biblioteca de	Wininet.lib
DLL de	Wininet.dll

Consulte también

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

funciones winINet

Compartir a través de