Función DeletePrinterDriver
La función DeletePrinterDriver quita el nombre del controlador de impresora especificado de la lista de nombres de controladores admitidos en un servidor.
Para eliminar los archivos asociados al controlador, además de quitar el nombre del controlador de impresora especificado de la lista de nombres de controladores admitidos para un servidor, use la función DeletePrinterDriverEx .
DeletePrinterDriver elimina un controlador solo si no hay ninguna versión del controlador en uso para el entorno especificado. DeletePrinterDriverEx puede eliminar versiones específicas del controlador.
Sintaxis
BOOL DeletePrinterDriver(
_In_ LPTSTR pName,
_In_ LPTSTR pEnvironment,
_In_ LPTSTR pDriverName
);
Parámetros
-
pName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del servidor desde el que se va a eliminar el controlador. Si este parámetro es NULL, el nombre del controlador de impresora se quitará localmente.
-
pEnvironment [in]
-
Puntero a una cadena terminada en null que especifica el entorno desde el que se va a eliminar el controlador (por ejemplo, Windows x86, Windows IA64 o Windows x64). Si este parámetro es NULL, el nombre del controlador se elimina del entorno actual de la aplicación que realiza la llamada y el equipo cliente (no de la aplicación de destino ni del servidor de impresión).
-
pDriverName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del controlador que se debe eliminar.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Nota:
Se trata de una función de bloqueo o sincrónica y 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 de controladores 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 autor de la llamada debe tener SeLoadDriverPrivilege.
La función DeletePrinterDriver no elimina los archivos asociados, sino que simplemente quita el nombre del controlador de la lista devuelta por la función EnumPrinterDrivers .
Antes de llamar a DeletePrinterDriver, debe eliminar todos los objetos de impresora que usen el controlador de impresora.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DeletePrinterDriverW (Unicode) y DeletePrinterDriverA (ANSI) |