estrutura JOB_INFO_2
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 |
|
| Nomes Unicode e ANSI |
_JOB_INFO_2W (Unicode) e _JOB_INFO_2A (ANSI) |