estrutura JOB_INFO_2

  • Artigo

A estrutura JOB_INFO_2 descreve um conjunto completo de valores associados a um trabalho.

Sintaxe

typedef struct _JOB_INFO_2 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
} JOB_INFO_2, *PJOB_INFO_2;

Membros

Jobid

Um valor de 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").

pNotifyName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do usuário que deve ser notificado quando o trabalho foi impresso ou quando ocorre um erro durante a impressão do trabalho.

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.

pPrintProcessor

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do processador de impressão que deve ser usado para imprimir o trabalho.

pParameters

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica parâmetros de processador de impressão.

pDriverName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do driver da impressora que deve ser usado para processar o trabalho de impressão.

pDevMode

Um ponteiro para uma estrutura DEVMODE que contém dados de ambiente e inicialização de dispositivo para o driver de impressora.

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.

pSecurityDescriptor

O valor desse membro é NULL. Não há suporte para recuperação e configuração de descritores de segurança de documentos nesta versão.

Status

O trabalho status. Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
JOB_STATUS_BLOCKED_DEVQ O driver não pode imprimir o trabalho.
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_SPOOLING O trabalho está sendo spooling.
JOB_STATUS_USER_INTERVENTION A impressora tem um erro que exige que o usuário faça algo.

No Windows XP e versões posteriores do Windows, os seguintes valores também podem ser usados:

Valor Significado
JOB_STATUS_COMPLETE O trabalho é enviado para a impressora, mas pode não ser impresso ainda. Confira Comentários para obter mais informações.
JOB_STATUS_RETAINED O trabalho foi mantido na fila de impressão após a impressão.

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.

StartTime

A primeira vez que o trabalho pode ser impresso.

UntilTime

A última vez em que o trabalho pode ser impresso.

Totalpages

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

Tamanho

O tamanho, em bytes, do trabalho.

Enviado

Uma estrutura SYSTEMTIME que especifica a hora em que o trabalho foi enviado.

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.

Hora

O tempo total, em milissegundos, decorrido desde que o trabalho começou a ser impresso.

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.

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_2W (Unicode) e _JOB_INFO_2A (ANSI)

Confira também

Impressão

Estruturas de API do Spooler de Impressão

DEVMODE

EnumJobs

Getjob

SetJob