ID do artigo: 160129 - �ltima revis�o: ter�a-feira, 21 de novembro de 2006 - Revis�o: 4.1

Como obter o status de uma impressora e um trabalho de impress�o

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Exibir os produtos aos quais esse artigo se aplica.

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

O status de impressoras e trabalhos de impress�o ser�o atualizados pelo Spooler Win32 durante despool de um trabalho de impress�o. Em todos os outros hor�rios, quando essa impressora n�o despooling e relat�rios n�o informa��es de estado, a impressora � considerada pronto e ocioso.

Voltar para o in�cio

Mais Informa��es

Como referido pela API do Win32, "impressora" � composta do driver de impressora, a fila de impress�o e o caminho de entrada/sa�da para a impressora f�sica. O sistema operacional trata uma impressora f�sica como simplesmente o destino de um trabalho de impress�o gerada pelo e passadas para um sistema "Impressora", mencionado o restante deste artigo como uma impressora.

A parte mais vis�vel de uma impressora � uma fila de impress�o. Ela � gerenciada pelo pastas impressora nas interfaces de usu�rio de estilo do Windows 95 ou o Gerenciador de impress�o. O driver de impressora � a interface para a impressora � usada por aplicativos para criar trabalhos de impress�o atrav�s da impressora DCs. O caminho de E/s para uma impressora consiste em v�rias camadas do c�digo do sistema culminating com um monitor de porta.

O monitor de porta � a interface para a impressora f�sica do final de fluxo para baixo de um sistema de impressora e � respons�vel por transfer�ncia de dados de um trabalho de impress�o em qualquer conex�o existe para a impressora f�sica. No caso do bi-direcional impressoras, o monitor de porta seria respons�vel para a transfer�ncia de dados e para a impressora f�sica. Esta conex�o e a impressora f�sica, s�o onde ocorrem erros. � o trabalho do monitor de porta para relatar esses erros.

O spooler n�o consulta para o estado de uma impressora f�sica � qual uma impressora est� conectada. Em vez disso, o estado de uma impressora f�sica determina o �xito de um trabalho de impress�o no momento � despooled sobre o monitor de porta. Se ocorrer algum erro nesse processo, o erro � relatado pelo monitor de porta e registrado em informa��es sobre o status do trabalho de impress�o. O spooler, por sua vez, propaga informa��es de erro razo�vel para a fila da impressora.

Conseq�entemente, um sistema de impressora relat�rios n�o status quando a fila de impressora est� vazia. Nesse estado, a impressora ser� considerada pronta para aceitar trabalhos de impress�o. Isso � uma suposi��o v�lida mesmo se a impressora f�sica est� em um erro, como estado off-line. O sistema operacional considera a impressora pronta para aceitar trabalhos de impress�o, mesmo se, por algum motivo, ele n�o pode concluir a entrega para a impressora f�sica. Como uma circunst�ncia � considerada um estado de erro no sistema operacional que deve ser tratado pelo usu�rio. Ele n�o � considerado um erro reportable para o aplicativo que � permitido para concluir o spool do trabalho de impress�o com �xito.

Voltar para o in�cio

Determinando o estado de uma impressora f�sica

H� um premissa fundamental que deve ser verdadeira para determinar o estado de uma impressora f�sica: o spooler deve ser tentando enviar um trabalho de impress�o para a impressora f�sica. Esta � a �nica vez que o estado da impressora � informado pelo monitor de porta. Al�m disso, as informa��es mais significativas podem ser reportadas nos membros de status de uma estrutura JOB_INFO para esse determinado trabalho de impress�o porque alguns monitor de porta ser� ter definido esses valores diretamente.

As estruturas JOB_INFO cont�m um membro de status e um membro pStatus . Os dois membros cont�m informa��es sobre o status de um trabalho de impress�o relatado pelo monitor de porta. Esses dois membros diferem em que o membro de status seja um campo de bits de estados que cont�m valores predeterminados, enquanto o membro pStatus � um ponteiro para uma seq��ncia que pode conter qualquer coisa. Esses valores s�o documentados pelo SDK do Win32 e o arquivo de cabe�alho WinSpool.h. O membro pStatus � definido de algumas vezes, mas n�o sempre, o como uma seq��ncia de status descritivo. O conte�do dessa seq��ncia de caracteres � definido por cada monitor de porta.

JOB_INFO estruturas s�o retornadas por duas fun��es de API: GetJob e EnumJobs. EnumJobs retorna uma matriz de estruturas JOB_INFO sem exigir que a refer�ncia de chamador um determinado trabalho na fila de impressora. O trabalho de impress�o que est� atualmente despooling (impress�o) cont�m as informa��es de status. Para localizar este trabalho na matriz, pesquise a matriz de estruturas JOB_INFO para localizar o trabalho de impress�o cujo status membro tem o conjunto JOB_STATUS_PRINTING bit.

Um m�todo mais f�cil de determinar o status da impressora � examinar o membro de status de uma estrutura PRINTER_INFO . Essa estrutura � retornada pela fun��o GetPrinter . H� uma desvantagem dessa abordagem em que n�o haja nenhum membro de seq��ncia de caracteres pStatus em uma estrutura PRINTER_INFO que pode fornecer informa��es de estado mais detalhado ou abrangentes. No entanto, h� uma vantagem de modo que um monitor de porta pode definida bits de status da estrutura PRINTER_INFO a alguns de impressora mais extenso. No entanto, observe que o monitor de porta padr�o para o Windows n�o geralmente define mais do que o bit PRINTER_STATUS_ERROR de membro de status da impressora.

Observe que os membros de status de um conjunto de estruturas podem conter informa��es de estado que n�o � estritamente relacionadas a impressora f�sica. Por exemplo, o membro de status de estruturas PRINTER_INFO pode ser definido com PRINTER_STATUS_PAUSED ou PRINTER_STATUS_PENDING_DELETION , que s�o estritamente relevantes para a fila de impress�o. Al�m disso, o membro de status da estrutura JOB_INFO pode conter valores de estado para JOB_STATUS_PAUSED ou JOB_STATUS_DELETING , que s�o relevantes somente para esse trabalho de impress�o espec�fico. Al�m disso, observe que os trabalhos de impress�o podem acumular em uma fila de impress�o ap�s eles t�m despooled e devem ser deixados com um estado de JOB_STATUS_PRINTED .

Cada uma dessas fun��es requer um identificador para uma impressora para identificar a impressora desejada. Esse identificador � obtido da fun��o OpenPrinter , que aceita uma cadeia de caracteres que cont�m o nome da impressora. Esse nome pode ser o nome local da impressora ou um UNC compartilhar nome em uma impressora de rede.

O c�digo de exemplo a seguir demonstra como chamar a fun��o EnumJobs adequadamente para recuperar JOB_INFO estruturas e como chamar a fun��o GetPrinter para recuperar PRINTER_INFO estruturas:

Voltar para o in�cio

C�digo de exemplo

   BOOL GetJobs(HANDLE hPrinter,        /* Handle to the printer. */ 

                JOB_INFO_2 **ppJobInfo, /* Pointer to be filled.  */ 
                int *pcJobs,            /* Count of jobs filled.  */ 
                DWORD *pStatus)         /* Print Queue status.    */ 

   {

   DWORD               cByteNeeded,
                        nReturned,
                        cByteUsed;
    JOB_INFO_2          *pJobStorage = NULL;
    PRINTER_INFO_2       *pPrinterInfo = NULL;

   /* Get the buffer size needed. */ 
       if (!GetPrinter(hPrinter, 2, NULL, 0, &cByteNeeded))
       {
           if (GetLastError() != ERROR_INSUFFICIENT_BUFFER)
               return FALSE;
       }

       pPrinterInfo = (PRINTER_INFO_2 *)malloc(cByteNeeded);
       if (!(pPrinterInfo))
           /* Failure to allocate memory. */ 
           return FALSE;

       /* Get the printer information. */ 
       if (!GetPrinter(hPrinter,
               2,
               (LPSTR)pPrinterInfo,
               cByteNeeded,
               &cByteUsed))
       {
           /* Failure to access the printer. */ 
           free(pPrinterInfo);
           pPrinterInfo = NULL;
           return FALSE;
       }

       /* Get job storage space. */ 
       if (!EnumJobs(hPrinter,
               0,
               pPrinterInfo->cJobs,
               2,
               NULL,
               0,
               (LPDWORD)&cByteNeeded,
               (LPDWORD)&nReturned))
       {
           if (GetLastError() != ERROR_INSUFFICIENT_BUFFER)
           {
               free(pPrinterInfo);
               pPrinterInfo = NULL;
               return FALSE;
           }
       }

       pJobStorage = (JOB_INFO_2 *)malloc(cByteNeeded);
       if (!pJobStorage)
       {
           /* Failure to allocate Job storage space. */ 
           free(pPrinterInfo);
           pPrinterInfo = NULL;
           return FALSE;
       }

       ZeroMemory(pJobStorage, cByteNeeded);

       /* Get the list of jobs. */ 
       if (!EnumJobs(hPrinter,
               0,
               pPrinterInfo->cJobs,
               2,
               (LPBYTE)pJobStorage,
               cByteNeeded,
               (LPDWORD)&cByteUsed,
               (LPDWORD)&nReturned))
       {
           free(pPrinterInfo);
           free(pJobStorage);
           pJobStorage = NULL;
           pPrinterInfo = NULL;
           return FALSE;
       }

       /*
        *  Return the information.
        */ 
       *pcJobs = nReturned;
       *pStatus = pPrinterInfo->Status;
       *ppJobInfo = pJobStorage;
       free(pPrinterInfo);

       return TRUE;

   }

   BOOL IsPrinterError(HANDLE hPrinter)
   {

       JOB_INFO_2  *pJobs;
       int         cJobs,
                   i;
       DWORD       dwPrinterStatus;

       /*
        *  Get the state information for the Printer Queue and
        *  the jobs in the Printer Queue.
        */ 
       if (!GetJobs(hPrinter, &pJobs, &cJobs, &dwPrinterStatus))
			return FALSE;

       /*
        *  If the Printer reports an error, believe it.
        */ 
       if (dwPrinterStatus &
           (PRINTER_STATUS_ERROR |
           PRINTER_STATUS_PAPER_JAM |
           PRINTER_STATUS_PAPER_OUT |
           PRINTER_STATUS_PAPER_PROBLEM |
           PRINTER_STATUS_OUTPUT_BIN_FULL |
           PRINTER_STATUS_NOT_AVAILABLE |
           PRINTER_STATUS_NO_TONER |
           PRINTER_STATUS_OUT_OF_MEMORY |
           PRINTER_STATUS_OFFLINE |
           PRINTER_STATUS_DOOR_OPEN))
       {
           free( pJobs );
           return TRUE;
       }

       /*
        *  Find the Job in the Queue that is printing.
        */ 
       for (i=0; i < cJobs; i++)
       {
           if (pJobs[i].Status & JOB_STATUS_PRINTING)
           {
               /*
                *  If the job is in an error state,
                *  report an error for the printer.
                *  Code could be inserted here to
                *  attempt an interpretation of the
                *  pStatus member as well.
                */ 
               if (pJobs[i].Status &
                   (JOB_STATUS_ERROR |
                   JOB_STATUS_OFFLINE |
                   JOB_STATUS_PAPEROUT |
                   JOB_STATUS_BLOCKED_DEVQ))
               {
                   free( pJobs );
                   return TRUE;
               }
           }
       }

       /*
        *  No error condition.
        */ 
       free( pJobs );
       return FALSE;

   }

Observa��o : quando a pool de impress�o estiver ativado no Windows NT, pode haver mais de um trabalho de impress�o despooling de uma fila de impressora relatar� um status. Este c�digo de exemplo n�o considera que circunst�ncia.

Voltar para o in�cio

Refer�ncias

Para informa��es adicionais sobre instru��es gerais na chamada Win32 Spooler fun��es, clique no n�mero abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:

158828� (http://support.microsoft.com/kb/158828/ ) Como a enumera��o de chamada Wind32 Spooler APIs corretamente

Voltar para o in�cio

A informa��o contida neste artigo aplica-se a:

Interface de Programa��o de Aplicativos do Microsoft Win32�nas seguintes plataformas

Microsoft Windows NT Server 3.51
Microsoft Windows NT Server 4.0 Standard Edition
Microsoft Windows NT Workstation 3.51
Microsoft Windows NT Workstation 4.0 Developer Edition
Microsoft Windows 95

Voltar para o in�cio

kbmt kbfaq kbhowto KB160129 KbMtpt

Voltar para o in�cio

Tradu��o autom�tica

IMPORTANTE: Este artigo foi traduzido por um sistema de tradu��o autom�tica (tamb�m designado por Machine Translation ou MT), n�o tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em portugu�s a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradu��o autom�tica n�o � sempre perfeita, podendo conter erros de vocabul�rio, sintaxe ou gram�tica. A Microsoft n�o � respons�vel por incoer�ncias, erros ou preju�zos ocorridos em decorr�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualiza��es freq�entes ao software de tradu��o autom�tica (MT). Obrigado.

Clique aqui para ver a vers�o em Ingl�s deste artigo: 160129� (http://support.microsoft.com/kb/160129/en-us/ )

Voltar para o in�cio

This site in other countries/regions:

Como obter o status de uma impressora e um trabalho de impress�o

Nesta p�gina

Sum�rio

Mais Informa��es

Determinando o estado de uma impressora f�sica

C�digo de exemplo

Refer�ncias

A informa��o contida neste artigo aplica-se a:

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Tradu��es deste artigo