Función InternetCheckConnectionA (wininet.h)

  • Artículo

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

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 una cadena terminada en null que 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 es NULL, 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 en caso contrario. Use GetLastError para recuperar el código de error. GetLastError devuelve ERROR_NOT_CONNECTED si no se puede establecer una conexión o si la base de datos de sockets está sin conexión incondicionalmente.

Comentarios

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 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 los 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 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

   
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
Library Wininet.lib
Archivo DLL Wininet.dll

Consulte también

Habilitación de la funcionalidad de Internet

Funciones de WinINet