estrutura JOB_INFO_1

A estrutura de JOB_INFO_1 especifica informações de trabalho de impressão, como o valor do identificador de trabalho, o nome da impressora para a qual o trabalho é spool, o nome do computador que criou o trabalho de impressão, o nome do usuário que possui o trabalho de impressão e assim por diante.

Sintaxe

typedef struct _JOB_INFO_1 {
  DWORD      JobId;
  LPTSTR     pPrinterName;
  LPTSTR     pMachineName;
  LPTSTR     pUserName;
  LPTSTR     pDocument;
  LPTSTR     pDatatype;
  LPTSTR     pStatus;
  DWORD      Status;
  DWORD      Priority;
  DWORD      Position;
  DWORD      TotalPages;
  DWORD      PagesPrinted;
  SYSTEMTIME Submitted;
} JOB_INFO_1, *PJOB_INFO_1;

Membros

Jobid

Um identificador de trabalho.

pPrinterName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da impressora para a qual o trabalho é spool.

pMachineName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do computador que criou o trabalho de impressão.

pUserName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do usuário que possui o trabalho de impressão.

pDocument

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do trabalho de impressão (por exemplo, "MS-WORD: Review.doc").

pDatatype

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o tipo de dados usado para registrar o trabalho de impressão.

pStatus

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o status do trabalho de impressão. Esse membro deve ser verificado antes de Status e, se pStatus for NULL, o status será definido pelo conteúdo do membro Status.

Status

O trabalho status. O valor desse membro pode ser zero ou uma combinação de um ou mais dos valores a seguir. Um valor zero indica que a fila de impressão foi pausada depois que o documento terminou o spooling.

Valor	Significado
JOB_STATUS_BLOCKED_DEVQ	O driver não pode imprimir o trabalho.
JOB_STATUS_COMPLETE	Windows XP e posterior: O trabalho é enviado para a impressora, mas o trabalho pode não ser impresso ainda. Confira Comentários para obter mais informações.
JOB_STATUS_DELETED	O trabalho foi excluído.
JOB_STATUS_DELETING	O trabalho está sendo excluído.
JOB_STATUS_ERROR	Um erro está associado ao trabalho.
JOB_STATUS_OFFLINE	A impressora está offline.
JOB_STATUS_PAPEROUT	A impressora está sem papel.
JOB_STATUS_PAUSED	O trabalho está em pausa.
JOB_STATUS_PRINTED	O trabalho foi impresso.
JOB_STATUS_PRINTING	O trabalho está sendo impresso.
JOB_STATUS_RESTART	O trabalho foi reiniciado.
JOB_STATUS_RETAINED	Windows Vista e posterior: O trabalho foi retido na fila de impressão e não pode ser excluído. Isso pode ser provocado pelo seguinte: 1) O trabalho foi retido manualmente por uma chamada para SetJob e o spooler está aguardando o lançamento do trabalho. 2) O trabalho não terminou a impressão e deve concluir a impressão antes de ser excluído automaticamente. Consulte SetJob para obter mais informações sobre comandos de trabalho de impressão.
JOB_STATUS_SPOOLING	O trabalho está sendo spooling.
JOB_STATUS_USER_INTERVENTION	A impressora tem um erro que exige que o usuário faça algo.

Prioridade

A prioridade do trabalho. Esse membro pode ser um dos seguintes valores ou no intervalo entre 1 e 99 (MIN_PRIORITY até MAX_PRIORITY).

Valor	Significado
MIN_PRIORITY	Prioridade mínima.
MAX_PRIORITY	Prioridade máxima.
DEF_PRIORITY	Prioridade padrão.

Posição

A posição do trabalho na fila de impressão.

Totalpages

O número total de páginas que o documento contém. Esse valor poderá ser zero se o trabalho de impressão não contiver informações de delimitação de página.

PagesPrinted

O número de páginas impressas. Esse valor poderá ser zero se o trabalho de impressão não contiver informações de delimitação de página.

Enviado

Uma estrutura SYSTEMTIME que especifica a hora em que este documento foi spool.

Esse valor de tempo está no formato UTC (Coordenada de Tempo Universal). Você deve convertê-lo em um valor de hora local antes de exibi-lo. Você pode usar a função FileTimeToLocalFileTime para executar a conversão.

Comentários

Monitores de porta que não dão suporte a TrueEndOfJob definirão o trabalho como JOB_STATUS_PRINTED logo após o trabalho ser enviado para a impressora.

Requisitos

Confira também

Impressão

Estruturas de API do Spooler de Impressão

EnumJobs

Getjob

SetJob