Compartilhar via

estrutura JOB_INFO_1

  • Artigo

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

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winspool.h (inclua Windows.h)
Nomes Unicode e ANSI
 _JOB_INFO_1W (Unicode) e _JOB_INFO_1A (ANSI)

Confira também

Impressão

Estruturas de API do Spooler de Impressão

EnumJobs

Getjob

SetJob