Compartir a través de


CDC::SetAbortProc

Instala el procedimiento abort para el trabajo de impresión.

int SetAbortProc(
   BOOL ( CALLBACK* lpfn )( HDC, int )
);

Parámetros

Valor devuelto

especifica el resultado de la función de SetAbortProc .Algunos de los valores siguientes son más probable que otros, pero todos son posibles.

  • 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 terminó el trabajo a través del administrador de impresión.

Comentarios

Si una aplicación es permitir que el trabajo de impresión está cancelado durante poner en cola, debe establecer la función de anulación antes de que el trabajo de impresión se inicia con la función miembro de StartDoc .El administrador de impresión llama a la función de anulación durante poner en cola para que la aplicación pueda cancelar el trabajo de impresión o para procesar condiciones de espacio en disco insuficiente.Si no se especifica ninguna función de anulación, el trabajo de impresión generará un error si no hay espacio en disco para poner en cola.

Observe que las características de Microsoft Visual C++ simplifican la creación de la función de devolución de llamada pasada a SetAbortProc.La dirección pasada a la función miembro de EnumObjects es un puntero a una función exportada con __declspec (dllexport) y con la convención de llamada de __stdcall .

Tampoco tiene que exportar el nombre de función en una instrucción de EXPORTACIONES en el archivo de definición de módulo de la aplicación.Puede usar el modificador de la función de EXPORTAR , como en

BOOL CALLBACK EXPORTAR AFunction ( HDC, int);

para hacer que el compilador emita el registro correspondiente de exportación para la exportación por nombre sin un alias.esto funciona para la mayoría necesita.Para algunos casos especiales, como exportar una función por ordinal o alias exportación, es necesario utilizar una instrucción de EXPORTACIONES en un archivo de definición de módulos.

Las interfaces de registro de devolución de llamada se diseñó ahora (debe pasar un puntero a función que señale a la clase de la derecha de la función para la devolución de llamada concreto).

Observe también que todas las funciones de devolución de llamada deben las excepciones de la Microsoft foundation class catch antes de volver a Windows, dado que las excepciones no se pueden producir entre límites de devolución de llamada.Para obtener más información sobre excepciones, vea el artículo excepciones.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía