Compartir a través de

Función InternetCheckConnectionA (wininet.h)

  • Artículo

[internetCheckConnection está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. En su lugar, use NetworkInformation.GetInternetConnectionProfile o las interfaces NLM de . ]

Permite a una aplicación comprobar si se puede establecer una conexión a Internet.

Sintaxis

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

Parámetros

[in] lpszUrl

Puntero a un cadena terminada en nullque especifica la dirección URL que se va a usar para comprobar la conexión. Este valor puede ser null.

[in] dwFlags

Opciones. FLAG_ICC_FORCE_CONNECTION es la única marca que está disponible actualmente. Si se establece esta marca, fuerza una conexión. Se intenta una conexión de sockets en el orden siguiente:

  • Si lpszUrl no esNULL, el valor de host se extrae de él y se usa para hacer ping a ese host específico.
  • Si lpszUrl es NULL y hay una entrada en la base de datos del servidor interno para el servidor más cercano, el valor de host se extrae de la entrada y se usa para hacer ping a ese servidor.

[in] dwReserved

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

Valor devuelto

Devuelve TRUE si una conexión se realiza correctamente o FALSE de lo contrario. Use getLastError para recuperar el código de error. ERROR_NOT_CONNECTED devuelve GetLastError si no se puede realizar una conexión o si la base de datos de sockets está sin conexión incondicionalmente.

Observaciones

InternetCheckConnection está en desuso. InternetCheckConnection no funciona en entornos que usan un servidor proxy web para acceder a Internet. En función del entorno, use NetworkInformation.GetInternetConnectionProfile o las interfaces NLM de para comprobar el acceso a Internet en su lugar.

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 InternetCheckConnection 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
biblioteca de Wininet.lib
DLL de Wininet.dll

Consulte también

habilitación de la funcionalidad de Internet

funciones winINet