Función EndDocPrinter

La función EndDocPrinter finaliza un trabajo de impresión para la impresora especificada.

Sintaxis

BOOL EndDocPrinter(
  _In_ HANDLE hPrinter
);

Parámetros

hPrinter [in]

Identificador de una impresora para la que se debe finalizar el trabajo de impresión. 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 se produce un error en la función, el valor devuelto es cero.

Observaciones

La función EndDocPrinter devuelve un error si el trabajo de impresión no se inició llamando a la función StartDocPrinter .

La secuencia de un trabajo de impresión es la siguiente:

1. Para iniciar un trabajo de impresión, llame a StartDocPrinter.
2. Para comenzar cada página, llame a StartPagePrinter.
3. Para escribir datos en una página, llame a WritePrinter.
4. Para finalizar cada página, llame a EndPagePrinter.
5. Repita 2, 3 y 4 para tantas páginas como sea necesario.
6. Para finalizar el trabajo de impresión, llame a EndDocPrinter.

Cuando una página de un archivo en cola supera aproximadamente 350 MB, puede no imprimirse y no enviar un mensaje de error. Por ejemplo, esto puede ocurrir al imprimir archivos EMF grandes. El límite de tamaño de página depende de muchos factores, como la cantidad de memoria virtual disponible, la cantidad de memoria asignada mediante la llamada a procesos y la cantidad de fragmentación en el montón del proceso.

Requisitos

Consulte también

Impresión

de funciones de API de administrador de trabajos de impresión

endPagePrinter de

startDocPrinter de

startPagePrinter de

WritePrinter de