Función InternetDial (winineti.h)

  • Artículo

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

Sintaxis

DWORD InternetDial(
  [in]  HWND    hwndParent,
  [in]  LPSTR   lpszConnectoid,
  [in]  DWORD   dwFlags,
  [out] LPDWORD 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).
 

Requisitos

Requisito Value
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 (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