DismRemoveDriver function
Removes an out-of-box driver from an offline image.
Syntax
HRESULT WINAPI DismRemoveDriver(
_In_ DismSession Session,
_In_ PCWSTR DriverPath
);
Parameters
Session [in]
A valid DismSession. The DismSession must be associated with an image. You can associate a session with an image by using the DismOpenSession.
DriverPath [in]
The published file name of the driver that has been added to the image, for example OEM1.inf. You can use DismGetDrivers to get the published name of the driver.
Return value
Returns S_OK on success.
Remarks
This function only supports offline images.
Important
Removing a boot-critical driver can make the offline Windows image unable to boot.
Example
HRESULT hr = S_OK;
hr = DismRemoveDriver(Session, "Oem1.inf");
Requirements
| Requirement | Description |
|---|---|
| Supported host platforms | DISM API can be used on any operating system supported by the Windows Assessment and Deployment Kit (Windows ADK). For more information, see the Windows ADK Technical Reference. |
| Supported image platforms | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Minimum supported client | Windows 7 [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
| Header | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |