Función DeletePrinter
La función DeletePrinter elimina el objeto de impresora especificado.
Sintaxis
BOOL DeletePrinter(
_Inout_ HANDLE hPrinter
);
Parámetros
-
hPrinter [in, out]
-
Identificador de un objeto de impresora que se eliminará. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.
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 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.
Si quedan trabajos de impresión que se van a procesar para la impresora especificada, DeletePrinter marca la impresora para su eliminación pendiente y, a continuación, la elimina cuando se han impreso todos los trabajos de impresión. No se pueden agregar trabajos de impresión a una impresora marcada para su eliminación pendiente.
No se puede mantener una impresora marcada para su eliminación pendiente, pero sus trabajos de impresión se pueden mantener, reanudar y reiniciar. Si la impresora se mantiene y hay trabajos para la impresora, DeletePrinter produce un error con ERROR_ACCESS_DENIED.
Tenga en cuenta que DeletePrinter no cierra el identificador que se le pasa. Por lo tanto, la aplicación todavía debe llamar a ClosePrinter.
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 |
|