DriverPackageUninstall function
Starting in Windows 10 Version 1607 (Redstone 1), the Driver Install Frameworks (DIFx) tools are no longer included in the WDK.
For more information, see DIFx Guidelines.
The DriverPackageUninstall function uninstalls the specified driver package from the system and removes the driver package.
Syntax
DWORD DriverPackageUninstall(
_In_PCTSTR DriverPackageInfPath,
_In_DWORD Flags,
_In_opt_PCINSTALLERINFO_W pInstallerInfo,
_Out_BOOL *pNeedReboot
);
Parameters
DriverPackageInfPath [in]
A pointer to a NULL-terminated string that supplies the fully qualified path of the driver package'sINF file of the driver package to uninstall.
Flags [in]
A bitwise OR of the flags in the following table that control the uninstall operation.
| Value | Meaning |
|---|---|
| 0x00000000 | DriverPackageUninstall performs a default uninstall operation. |
| DRIVER_PACKAGE_DELETE_FILES | DriverPackageUninstall removes the binary files that were copied to the system when the [driver package](https://msdn.microsoft.com/library/windows/hardware/ff544840) was installed. A caller should use this flag with caution. A caller should only use this flag if the caller can verify that a binary file in the system is not required by any other driver package or application.
|
| DRIVER_PACKAGE_FORCE | DriverPackageUninstall uninstalls the driver package even if the driver package is currently associated with an installed application or is installed on devices in the device tree. A caller should use this flag with caution. For more information, see the following Remarks section. |
| DRIVER_PACKAGE_SILENT | DriverPackageUninstall uninstalls the driver package without displaying any user dialog boxes or other user messages. If a user dialog box is required to complete the uninstall operation, the driver package is not uninstalled. If an error occurs during the uninstall operation, the function returns a status code that indicates the type of error. |
pInstallerInfo [in, optional]
A pointer to a constant INSTALLERINFO structure that supplies information about an application, if any, that was associated with a driver package when the driver package was installed by a call to DriverPackageInstall. This pointer is optional and can be NULL.
pNeedReboot [out]
A pointer to a BOOL-typed variable. On return, this variable indicates, if TRUE, that a system restart is required to complete the uninstall operation. If the value, on return, is FALSE, a system restart is not required.
Return value
DriverPackageUninstall returns ERROR_SUCCESS if the driver package was successfully uninstalled. Otherwise, the function did not uninstall the driver package and returns an error code that indicates the cause of the failure. The following tables contains the most common return values.
| Return code | Description |
|---|---|
| CRYPT_E_FILE_ERROR | The catalog file for the specified driver package was not found; or possibly, some other error occurred when DriverPackageUninstall tried to verify the driver package signature. |
| ERROR_ACCESS_DENIED | A caller of DriverPackageUninstall must be a member of the Administrators group to uninstall a driver package. |
| ERROR_BAD_ENVIRONMENT | The current Microsoft Windows version does not support this operation. An old or incompatible version of DIFxApp.dll or DIFxAppA.dll might be present in the system. |
| ERROR_CANT_ACCESS_FILE | The driver package files could not be accessed. One possibility is that the specified INF file is in the system INF directory and the driver package is not preinstalled. |
| ERROR_DEPENDENT_APPLICATIONS_EXIST | DriverPackageUninstall removed an association between the driver package and the specified application but the function did not uninstall the driver package because other applications are associated with the driver package. For more information, see the following Remarks section. |
| ERROR_DRIVER_PACKAGE_NOT_IN_STORE | There is no INF file that corresponds to the INF file that was specified by DriverPackageInfPath. |
| ERROR_FILE_NOT_FOUND | The INF file that was specified by DriverPackageInfPath was not found. |
| ERROR_FILENAME_EXCED_RANGE | The length, in characters, of the specified INF file path is greater than the maximum supported length. |
| ERROR_IN_WOW64 | The 32-bit version DIFxAPI does not work on Win64 systems. A 64-bit version of DIFxAPI is required. |
| ERROR_INSTALL_FAILURE | The uninstall operation failed. |
| ERROR_INVALID_NAME | The specified INF file path is not valid. |
| ERROR_INVALID_PARAMETER | A supplied parameter is not valid. |
| ERROR_OUTOFMEMORY | Available system memory was insufficient to perform the operation. |
| ERROR_SHARING_VIOLATION | A component of the driver package is locked by a thread or process. This error can occur if a process or thread, other than the thread or process of the caller, is currently accessing the same driver package as the caller. |
| ERROR_UNSUPPORTED_TYPE | The driver package type is not supported. |
Remarks
A caller of DriverPackageUninstall must be a member of the Administrators group; otherwise, the function does not uninstall a driver package and returns ERROR_ACCESS_DENIED.
If the corresponding driver package is signed, the catalog file for the driver package must be in the same directory as the INF file. Otherwise, the uninstall operation will fail and DriverPackageUninstall will return CRYPT_E_FILE_ERROR.
By default, if the specified driver package is associated with an application other than the application that is specified by pInstallerInfo, DriverPackageUninstall removes the association between the driver package and the specified application, does not uninstall the driver package, and returns ERROR_DEPENDENT_APPLICATIONS_EXIST. To force the function to uninstall a driver package even if the package is associated with other applications, the caller can specify the DRIVER_PACKAGE_FORCE flag. However, a caller should use this flag with caution. If a caller forces an uninstall operation, the applications that are associated with the driver package might not function correctly. One possible use of this flag is to remove a driver that is causing the system not to function correctly.
Requirements
| Target platform | Desktop |
| Version | Available for Microsoft Windows 2000 and later versions of Windows. |
| Header | Difxapi.h (include Difxapi.h) |
| Library | Difxapi.lib |