Función GetJob

La función GetJob recupera información sobre un trabajo de impresión especificado.

Sintaxis

BOOL GetJob(
  _In_  HANDLE  hPrinter,
  _In_  DWORD   JobId,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pJob,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parámetros

hPrinter [in]

Identificador de la impresora para la que se recuperan los datos del trabajo de impresió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.

Nivel [in]

Tipo de información devuelta en el búfer de pJob . Si Level es 1, pJob recibe una estructura de JOB_INFO_1 . Si Level es 2, pJob recibe una estructura de JOB_INFO_2 .

pJob [out]

Puntero a un búfer que recibe un JOB_INFO_1 o una estructura de JOB_INFO_2 que contiene información sobre el trabajo. El búfer debe ser lo suficientemente grande como para almacenar las cadenas a las que apuntan los miembros de la estructura.

Para determinar el tamaño de búfer necesario, llame a GetJob con cbBuf establecido en cero. GetJob produce un error, GetLastError devuelve ERROR_INSUFFICIENT_BUFFER y el parámetro pcbNeeded devuelve el tamaño, en bytes, del búfer necesario para contener la matriz de estructuras y sus datos.

cbBuf [in]

Tamaño, en bytes, de la matriz.

pcbNeeded [ out]

Puntero a un valor que especifica el número de bytes copiados si la función se realiza correctamente o el número de bytes necesarios si cbBuf es demasiado pequeño.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

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

Observaciones

Nota

Se trata de una función de bloqueo o sincrónica que 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 del controlador 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.

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]
Encabezado	Winspool.h (incluya Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Winspool.drv
Nombres Unicode y ANSI	GetJobW (Unicode) y GetJobA (ANSI)

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

AddJob

JOB_INFO_1

JOB_INFO_2

ScheduleJob

SetJob