Función SetAbortProc (wingdi.h)

Artículo
08/27/2023

La función SetAbortProc establece la función abort definida por la aplicación que permite cancelar un trabajo de impresión durante la cola.

Sintaxis

int SetAbortProc(
  [in] HDC       hdc,
  [in] ABORTPROC proc
);

Parámetros

[in] hdc

Controle el contexto del dispositivo para el trabajo de impresión.

[in] proc

Puntero a la función abort definida por la aplicación. Para obtener más información sobre la función de devolución de llamada, consulte la función AbortProc callback.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es mayor que cero.

Si se produce un error en la función, el valor devuelto es SP_ERROR.

Comentarios

Nota Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que esta función devuelve depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y la implementación del controlador de impresora, factores 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.

Ejemplos

Para obtener un ejemplo, vea Cómo recopilar información del trabajo de impresión del usuario.

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]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll