LaunchConnectionDialog Function

Launches the Internet Properties dialog box with the Connections tab displayed.

Syntax

Copy

BOOL LaunchConnectionDialog(
    HWND hParent
);

Parameters

hParent

A handle to the parent window of the Internet Properties dialog box. This parameter can be NULL.

Return Value

Returns TRUE if successful, or FALSE otherwise.

Remarks

Use the LoadLibrary function and the GetProcAddress function to import LaunchConnectionDialog from Inetcpl.cpl.

Example

This example shows how to use LoadLibrary and GetProcAddress to load and call LaunchConnectionDialog.

Security Alert  Using LoadLibrary incorrectly can compromise the security of your application by loading the wrong DLL. Refer to the LoadLibrary documentation for information on how to correctly load DLLs with different versions of Windows.

Copy

typedef BOOL (WINAPI *LAUNCHCPL) (HWND);
HMODULE hInetcpl;
HWND hParent;
LAUNCHCPL cpl;

hInetcpl = LoadLibrary("inetcpl.cpl");

if (hInetcpl == NULL)
{
   //Error loading module -- fail as securely as possible
   return;
}
   
cpl = (LAUNCHCPL)GetProcAddress(hInetcpl, "LaunchConnectionDialog");
if(cpl)
{
  cpl(hParent);
}
FreeLibrary(hInetcpl);

Function Information

Stock Implementation	Inetcpl.cpl
Custom Implementation	No
Import library	None
Minimum availability	Internet Explorer 5
Minimum operating systems	Windows NT 4.0, Windows 95