Función InternetAutodial (winineti.h)

  • Artículo

Hace que el módem marque automáticamente la conexión a Internet predeterminada.

Sintaxis

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

Parámetros

[in] dwFlags

Controla esta operación. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
INTERNET_AUTODIAL_FAILIFSECURITYCHECK
0x04
 Hace que InternetAutodial produzca un error si el uso compartido de archivos e impresoras está deshabilitado para Windows 95 o posterior.

Windows Server 2008 y Windows Vista: Esta marca está obsoleta.
INTERNET_AUTODIAL_FORCE_ONLINE
0x01
 Fuerza una conexión a Internet en línea.
INTERNET_AUTODIAL_FORCE_UNATTENDED
0x02
 Fuerza una llamada a Internet desatendida.
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
0x08
 Hace que InternetAutodial marque la conexión del módem incluso cuando haya una conexión de red a Internet.

[in] hwndParent

Identificador de la ventana primaria.

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.

Comentarios

InternetAutodial 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 .
 
InternetAutodial no intenta marcar si hay una conexión de acceso telefónico existente en el sistema. Además, si hay una conexión LAN existente e InternetAutodial no está configurado para forzar la marcación (establezca el INTERNET_AUTODIAL_FORCE_ONLINE en el parámetro dwFlags ), InternetAutodial no intenta marcar la conexión y devuelve TRUE.

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

Consulte también

Establecimiento de una conexión de acceso telefónico a Internet

Funciones de WinINet