Función InternetDialW (wininet.h)

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 un cadena terminada en nullque 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 siguientes valores.

Valor	Significado
INTERNET_AUTODIAL_FORCE_ONLINE	Fuerza una conexión en línea.
INTERNET_AUTODIAL_FORCE_UNATTENDED	Fuerza un acceso telefónico a Internet desatendido. 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 mostrar 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á a la entrada del usuario.
INTERNET_DIAL_SHOW_OFFLINE	Muestra el botón Trabajar sin conexión en lugar del botón Cancelar de 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 siguientes valores.

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 botón Cancelar del cuadro de diálogo Conexión a Internet.

Observaciones

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

Nota a partir de Windows Vista y Windows Server 2008, las funciones de marcado de WinINet usan las funciones de 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 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