CDC::AbortDoc

Artículo
02/19/2013

Finaliza el trabajo de impresión actual y borra todo que la aplicación ha escrito en el dispositivo desde la última llamada a la función miembro de StartDoc .

int AbortDoc( );

Valor devuelto

Un valor mayor o igual que 0 si es correcto, o un valor negativo si se produce un error.La lista siguiente muestra valores de error comunes y sus significados:

Error deSP_ERROR General.
SP_OUTOFDISK No hay espacio en disco está disponible actualmente para poner en cola, y no más de espacio estará disponible.
SP_OUTOFMEMORY No suficiente memoria disponible para poner en cola.
El usuario deSP_USERABORT finalizó el trabajo a través del administrador de impresión.

Comentarios

Esta función miembro reemplaza el escape de impresora de ABORTDOC .

AbortDoc se debe utilizar para finalizar el siguiente:

Operaciones de impresión que no especifican una función de anulación mediante SetAbortProc.
Operaciones de impresión que aún no han alcanzado llamada de su primer escape de NEWFRAME o de NEXTBAND .

Si una aplicación encuentra un error de impresión o de impresión cancelado, no debería intentar finalizar la operación mediante las funciones miembro de EndDoc o de AbortDoc de la clase CDC.GDI automáticamente finaliza la operación antes de devolver el valor de error.

Si la aplicación muestra un cuadro de diálogo para permitir al usuario cancelar la operación de impresión, debe llamar a AbortDoc antes de destruir el cuadro de diálogo.

Si utilizó el administrador de impresión para iniciar el trabajo de impresión, llamando a AbortDoc borra el trabajo completo de cola — la impresora no recibe ninguna acción.Si no se utilizó el administrador de impresión para iniciar el trabajo de impresión, los datos se hayan enviado a la impresora antes de que AbortDoc se denomina.En este caso, el controlador de impresora habría restablecido la impresora (cuando sea posible) y se cierra el trabajo de impresión.