The SetupDiInstallClassEx function installs a class installer or an interface class.
WINSETUPAPI BOOL SetupDiInstallClassExA( HWND hwndParent, PCSTR InfFileName, DWORD Flags, HSPFILEQ FileQueue, CONST GUID *InterfaceClassGuid, PVOID Reserved1, PVOID Reserved2 );
The handle to the parent window for any user interface that is used to install this class. This parameter is optional and can be NULL.
A pointer to a NULL-terminated string that contains the name of an INF file. This parameter is optional and can be NULL. If this function is being used to install a class installer, the INF file contains an INF ClassInstall32 section and this parameter must not be NULL.
If this function is being used to install an interface class, the INF file contains an INF InterfaceInstall32 section.
A value of type DWORD that controls the installation process. Flags can be zero or a bitwise OR of the following values:
Set this flag if FileQueue is supplied.
DI_NOVCP instructs the SetupInstallFromInfSection function not to create a queue of its own and to use the caller-supplied queue instead.
If this flag is set, files are not copied just queued.
For more information about the SetupInstallFromInfSection function, see the Microsoft Windows SDK documentation.
Set this flag to disable browsing if a copy operation cannot find a specified file. If the caller supplies a file queue, this flag is ignored.
Set this flag to always copy files, even if they are already present on the user's computer. If the caller supplies a file queue, this flag is ignored.
Set this flag to suppress the user interface unless absolutely necessary. For example, do not display the progress dialog. If the caller supplies a file queue, this flag is ignored.
If the DI_NOVCP flag is set, this parameter supplies a handle to a file queue where file operations should be queued but not committed.
A pointer to a GUID that identifies the interface class to be installed. This parameter is optional and can be NULL. If this parameter is specified, this function is being used to install the interface class represented by the GUID. If this parameter is NULL, this function is being used to install a class installer.
Reserved. Must be zero.
Reserved. Must be zero.
SetupDiInstallClassEx returns TRUE if it is successful. Otherwise, it returns FALSE and the logged error can be retrieved with a call to GetLastError.
The caller of this function must be a member of the Administrators group.
|Windows version||Available in Microsoft Windows 2000 and later versions of Windows.|
|Header||setupapi.h (include Setupapi.h)|