LaunchINFSection function
Launches a portion of an information (.inf) file.
Syntax
int WINAPI LaunchINFSection(
HWND hwndOwner,
HINSTANCE hInstance,
PSTR pszParams,
INT nShow
);
Parameters
hwndOwner
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.
hInstance
Handle to the instance of the program. This parameter is typically NULL.
pszParams
Comma-delimited string that specifies the following in the order listed.
- 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.
- 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.
- The fully qualified path of a cabinet file (.cab) that contains the .inf file.
- Flags that specify the installation mode.
The following flags are used to specify the installation mode.
LIS_QUIET (0x0001)
Quiet mode, no UI.
LIS_NOGRPCONV (0x0002)
Don't run GrpConv.
nShow
Not used.
Return value
Returns one of the following values.
Return code | Description |
---|---|
The section launched successfully. |
|
1 | The section failed to launch. |
Remarks
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.
Examples
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\mydata.cab file in Quiet|Backup mode, launch the DefaultInstall section, and reboot if needed.
rundll32.exe advpack.dll,LaunchINFSection myinf.inf,,c:\temp\mydata.cab,36
Requirements
Minimum supported client |
Windows 2000 Professional |
Minimum supported server |
Windows 2000 Server |
Header |
N/A |
DLL |
Advpack.dll |
See also
Conceptual