DeletePrinterDriverPackage function
Deletes a printer driver package from the driver store.
Syntax
HRESULT DeletePrinterDriverPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszEnvironment
);
Parameters
-
pszServer [in]
-
A pointer to a constant, null-terminated string that specifies the name of the print server from which the driver package is being deleted. A NULL pointer value means the local computer.
-
pszInfPath [in]
-
A pointer to a constant, null-terminated string that specifies the path to the driver's *.inf file.
-
pszEnvironment [in]
-
A pointer to a constant, null-terminated string that specifies the processor architecture (for example, Windows NT x86). This can be NULL.
Return value
S_OK, if the operation succeeds.
E_ACCESSDENIED, if the package was shipped with Windows.
HRESULT_CODE(ERROR_PRINT_DRIVER_PACKAGE_IN_USE), if the package is being used.
Otherwise the HRESULT will contain an error code.
For more information about COM error codes, see Error Handling.
Remarks
Note
This is a blocking or synchronous function and might not return immediately. How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation factors that are difficult to predict when writing an application. Calling this function from a thread that manages interaction with the user interface could make the application appear to be unresponsive.
The driver store is typically %windir%\inf or %windir%\System32\DriverStore\FileRepository.
A driver package that shipped with Windows cannot be removed with this function.
The user must have printer administration privileges.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| Header |
|
| Library |
|
| DLL |
|
| Unicode and ANSI names |
DeletePrinterDriverPackageW (Unicode) and DeletePrinterDriverPackageA (ANSI) |