Función ReportJobProcessingProgress
Informa al servicio Print Spooler si un trabajo de impresión XPS está en cola o en la fase de representación y qué parte del procesamiento está actualmente en curso.
Sintaxis
HRESULT ReportJobProcessingProgress(
_In_ HANDLE printerHandle,
_In_ ULONG jobId,
EPrintXPSJobOperation jobOperation,
EPrintXPSJobProgress jobProgress
);
Parámetros
-
printerHandle [in]
-
Identificador de impresora para el que la función va a recuperar información. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.
-
jobId [in]
-
Identifica el trabajo de impresión para el que se van a recuperar los datos. Use la función AddJob o la función StartDoc para obtener un identificador de trabajo de impresión.
-
jobOperation
-
Especifica si el trabajo está en la fase de cola o en la fase de representación.
-
jobProgress
-
Especifica qué parte del procesamiento está actualmente en curso. Este valor hace referencia a eventos en la fase de puesta en cola o representación en función del valor de jobOperation.
Valor devuelto
Si la operación se realiza correctamente, se S_OK el valor devuelto; de lo contrario, HRESULT contendrá un código de error.
Para obtener más información sobre los códigos de error COM, vea Control de errores.
Comentarios
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.
Nota
ReportJobProcessingProgress solo notificará el progreso del trabajo de impresión XPS si el trabajo de impresión está en la fase de puesta en cola o representación. ReportJobProcessingProgress producirá un error si se llama cuando el trabajo de impresión XPS no está en la fase de puesta en cola o representación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|