Función InternetDialW (wininet.h)

  • Artículo

Inicia una conexión a Internet mediante un módem.

Sintaxis

DWORD InternetDialW(
  [in]  HWND      hwndParent,
  [in]  LPWSTR    lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

Parámetros

[in] hwndParent

Identificador de la ventana primaria.

[in] lpszConnectoid

Puntero a una cadena terminada en null que especifica el nombre de la conexión de acceso telefónico que se va a usar. Si este parámetro contiene la cadena vacía (""), el usuario elige la conexión. Si este parámetro es NULL, la función se conecta a la conexión autodial.

[in] dwFlags

Opciones. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
INTERNET_AUTODIAL_FORCE_ONLINE
 Fuerza una conexión en línea.
INTERNET_AUTODIAL_FORCE_UNATTENDED
 Fuerza una llamada a Internet desatendida. Si se requiere la intervención del usuario, se producirá un error en la función.
INTERNET_DIAL_FORCE_PROMPT
 Omite la configuración de "marcar automáticamente" y obliga a que se muestre la interfaz de usuario de marcado.
INTERNET_DIAL_UNATTENDED
 Se conecta a Internet a través de un módem, sin mostrar una interfaz de usuario, si es posible. De lo contrario, la función esperará la entrada del usuario.
INTERNET_DIAL_SHOW_OFFLINE
 Muestra el botón Trabajar sin conexión en lugar del botón Cancelar en la interfaz de usuario de marcado.

[out] lpdwConnection

Puntero a una variable que especifica el número de conexión. Este número es un identificador único para la conexión que se puede usar en otras funciones, como InternetHangUp.

[in] dwReserved

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

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un valor de error de lo contrario. El código de error puede ser uno de los valores siguientes.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros son incorrectos.
ERROR_NO_CONNECTION
 Hay un problema con la conexión de acceso telefónico.
ERROR_USER_DISCONNECTION
 El usuario ha realizado clic en el botón Trabajar sin conexión o Cancelar en el cuadro de diálogo Conexión a Internet.

Comentarios

InternetDial no admite conexiones de doble marcado, autenticación de Tarjeta inteligente o conexiones que requieren una certificación basada en el registro.

Nota A partir de Windows Vista y Windows Server 2008, las funciones de marcado winINet usan las funciones ras para establecer una conexión de acceso telefónico. WinINet admite la funcionalidad documentada en la función RasDialDlg .
 
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 InternetDial 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 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 (incluye 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