Función InternetGoOnlineA (winineti.h)

  • Artículo

Solicita al usuario permiso para iniciar la conexión a una dirección URL.

Sintaxis

BOOL InternetGoOnlineA(
  [in] LPCSTR lpszURL,
  [in] HWND   hwndParent,
  [in] DWORD  dwFlags
);

Parámetros

[in] lpszURL

Puntero a una cadena terminada en null que especifica la dirección URL del sitio web para la conexión.

[in] hwndParent

Identificador de la ventana primaria.

[in] dwFlags

Este parámetro puede ser cero o la marca siguiente.

Value Significado
INTERNET_GOONLINE_REFRESH
 Esta marca no se usa.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Las aplicaciones pueden llamar a GetLastError para recuperar el código de error.

Si se produce un error en las funciones, puede devolver el siguiente código de error:

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros son incorrectos.

El parámetro dwFlags contiene un valor distinto de cero o INTERNET_GOONLINE_REFRESH.

Comentarios

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