InternetDial Function

Initiates a connection to the Internet using a modem connection.

Syntax

DWORD InternetDial%(
    IN HWND hwndParent,
    IN LPTSTR% lpszConnectoid,
    IN DWORD dwFlags,
    OUT LPDWORD lpdwConnection,
    IN DWORD dwReserved
);

The actual syntax of this function varies between its ANSI and Unicode implementations. See the Win32 Internet Functions Syntax document for details.

Parameters

hwndParent

Handle to the parent window.

lpszConnectoid

Address of a string variable containing the name of the dial-up connection to use.

dwFlags

Unsigned long integer value that contains the flags to use. This can be one of the following values:

INTERNET_AUTODIAL_FORCE_ONLINE

Forces an online connection.

INTERNET_AUTODIAL_FORCE_UNATTENDED

Forces an unattended Internet dial-up. If user intervention is required, the function will fail.

INTERNET_DIAL_UNATTENDED

Connects to the Internet through a modem, without displaying a user interface, if possible. Otherwise, the function will wait for user input.

INTERNET_DIAL_SHOW_OFFLINE

lpdwConnection

Address of an unsigned long integer value containing the number associated to the connection.

dwReserved

Reserved. Must be set to zero.

Return Value

Returns ERROR_SUCCESS if successful, or an error code otherwise.

Function Information

Windows NT	Use version 4.0 and later. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 4.0 (ANSI only), 5 (ANSI and Unicode)

See Also

Microsoft Win32 Internet Functions Overview, Establishing a Dial-Up Connection to the Internet, Microsoft Win32 Internet Functions Reference, Automatic Dialing Functions

Does this content meet your programming needs? Write us!

Back to top