LaunchINFSection function

Launches a portion of an information (.inf) file.


int WINAPI LaunchINFSection(
   HWND      hwndOwner,
   HINSTANCE hInstance,
   PSTR      pszParams,
   INT       nShow



HWND that specifies the owner window on which to display error messages. This parameter is typically NULL, which causes the desktop to be the owner window.


Handle to the instance of the program. This parameter is typically NULL.


Comma-delimited string that specifies the following in the order listed.

  1. The .inf file. If you do not specify the fully qualified path of the .inf file, the .inf file is extracted from the .cab file specified below.
  2. The section of the .inf file to launch. If you do not specify a section then the DefaultInstall section of the .inf file is launched.
  3. The fully qualified path of a cabinet file (.cab) that contains the .inf file.
  4. Flags that specify the installation mode.

The following flags are used to specify the installation mode.

LIS_QUIET (0x0001)

Quiet mode, no UI.


Don't run GrpConv.


Not used.

Return value

Returns one of the following values.

Return code Description

The section launched successfully.


The section failed to launch.



You can call this function using Rundll32.exe from the command line.

Note  Using an entry point function with Rundll32.exe does not resemble a normal function call. The function name and the name of the .dll file where it is stored are used only as command line parameters. The function definition shown in the Syntax section of this topic is only a standard prototype for all functions that you can call using Rundll32. The specific values for hwndOwner and hInstance are not provided by the user, but are handled behind the scenes by Rundll32.



The following examples demonstrate how to call the LaunchINFSection function using Rundll32.

This example demonstrates how to extract the myinf.inf file from the c:\temp\ file in Quiet|Backup mode, launch the DefaultInstall section, and reboot if needed.

rundll32.exe advpack.dll,LaunchINFSection myinf.inf,,c:\temp\,36


Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server





See also


About INF File Architecture

Using INF Files