Función InternetAutodial (wininet.h)

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	wininet.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