Función ClosePrinter

La función ClosePrinter cierra el objeto de impresora especificado.

Sintaxis

BOOL ClosePrinter(
  _In_ HANDLE hPrinter
);

Parámetros

hPrinter [in]

Identificador del objeto de impresora que se va a cerrar. La función OpenPrinter o AddPrinter devuelve este identificador.

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.

Observaciones

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.

Cuando se devuelve la función ClosePrinter , el identificador hPrinter no es válido, independientemente de si la función se ha realizado correctamente o no.

Ejemplos

Para obtener un programa de ejemplo que use esta función, consulte How To: Print Using the GDI Print API.

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
Winspool.h (include Windows.h)
Biblioteca
Winspool.lib
Archivo DLL
Spoolss.dll

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

Addprinter

OpenPrinter