Función DeletePrinterDriverPackage
Elimina un paquete de controladores de impresora del almacén de controladores.
Sintaxis
HRESULT DeletePrinterDriverPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszEnvironment
);
Parámetros
-
pszServer [in]
-
Puntero a una cadena constante terminada en null que especifica el nombre del servidor de impresión desde el que se va a eliminar el paquete de controladores. Un valor de puntero NULL significa el equipo local.
-
pszInfPath [in]
-
Puntero a una cadena constante terminada en null que especifica la ruta de acceso al archivo *.inf del controlador.
-
pszEnvironment [in]
-
Puntero a una cadena constante terminada en null que especifica la arquitectura del procesador (por ejemplo, Windows NT x86). Puede ser NULL.
Valor devuelto
S_OK, si la operación se realiza correctamente.
E_ACCESSDENIED, si el paquete se envió con Windows.
HRESULT_CODE(ERROR_PRINT_DRIVER_PACKAGE_IN_USE), si se usa el paquete.
De lo contrario, HRESULT contendrá un código de error.
Para obtener más información sobre los códigos de error COM, vea Control de errores.
Comentarios
Nota:
Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación del controlador de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.
El almacén de controladores suele ser %windir%\inf o %windir%\System32\DriverStore\FileRepository.
No se puede quitar un paquete de controladores que se incluye con Windows con esta función.
El usuario debe tener privilegios de administración de impresoras.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DeletePrinterDriverPackageW (Unicode) y DeletePrinterDriverPackageA (ANSI) |