Export (0) Print
Expand All
Expand Minimize
2 out of 5 rated this helpful - Rate this topic

InternetAutodial function

Causes the modem to automatically dial the default Internet connection.

Syntax


BOOL InternetAutodial(
  _In_  DWORD dwFlags,
  _In_  HWND hwndParent
);

Parameters

dwFlags [in]

Controls this operation. This parameter can be one of the following values.

ValueMeaning
INTERNET_AUTODIAL_FAILIFSECURITYCHECK
0x04

Causes InternetAutodial to fail if file and printer sharing is disabled for Windows 95 or later.

Windows Server 2008 and Windows Vista:  This flag is obsolete.

INTERNET_AUTODIAL_FORCE_ONLINE
0x01

Forces an online Internet connection.

INTERNET_AUTODIAL_FORCE_UNATTENDED
0x02

Forces an unattended Internet dial-up.

INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
0x08

Causes InternetAutodial to dial the modem connection even when a network connection to the Internet is present.

 

hwndParent [in]

Handle to the parent window.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. Applications can call GetLastError to retrieve the error code.

Remarks

InternetAutodial does not support double-dial connections, SmartCard authentication, or connections that require registry-based certification.

Note  Starting on Windows Vista and Windows Server 2008, the WinINet dial-up functions use the RAS functions to establish a dial-up connection. WinINet supports the functionality documented in the RasDialDlg function.

InternetAutodial does not attempt to dial if there is an existing dial-up connection on the system. Also, if there is an existing LAN connection, and InternetAutodial is not configured to force dial (set the INTERNET_AUTODIAL_FORCE_ONLINE in the dwFlags parameter), InternetAutodial does not attempt to dial the connection and returns TRUE.

Like all other aspects of the WinINet API, this function cannot be safely called from within DllMain or the constructors and destructors of global objects.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

See also

Establishing a Dial-Up Connection to the Internet
WinINet Functions

 

 

Show:
© 2014 Microsoft. All rights reserved.