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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Winspool.h (include Windows.h)

Library

Winspool.lib

DLL

Spoolss.dll

Unicode and ANSI names

DeletePrinterDriverPackageW (Unicode) and DeletePrinterDriverPackageA (ANSI)

See also

Printing
Print Spooler API Functions

 

 

Show: