Compartilhar via

estrutura PORT_INFO_3

  • Artigo

A estrutura PORT_INFO_3 especifica o valor status de uma porta de impressora.

Sintaxe

typedef struct _PORT_INFO_3 {
  DWORD  dwStatus;
  LPTSTR pszStatus;
  DWORD  dwSeverity;
} PORT_INFO_3, *PPORT_INFO_3;

Membros

Dwstatus

A nova porta status valor. Esse valor será usado somente se o membro pszStatus for NULL.

Esse membro pode ser um dos valores a seguir.

Valor Significado
0 Limpa a porta da impressora status.
PORT_STATUS_OFFLINE A impressora da porta está offline.
PORT_STATUS_PAPER_JAM A impressora da porta tem uma geléia de papel.
PORT_STATUS_PAPER_OUT A impressora da porta está sem papel.
PORT_STATUS_OUTPUT_BIN_FULL O compartimento de saída da impressora da porta está cheio.
PORT_STATUS_PAPER_PROBLEM A impressora da porta tem um problema de papel.
PORT_STATUS_NO_TONER A impressora da porta está sem toner.
PORT_STATUS_DOOR_OPEN A porta da impressora da porta está aberta.
PORT_STATUS_USER_INTERVENTION A impressora da porta requer intervenção do usuário.
PORT_STATUS_OUT_OF_MEMORY A impressora da porta está sem memória.
PORT_STATUS_TONER_LOW A impressora da porta está com pouco toner.
PORT_STATUS_WARMING_UP A impressora da porta está aquecendo.
PORT_STATUS_POWER_SAVE A impressora da porta está em um modo de conservação de energia.

pszStatus

Ponteiro para uma nova porta da impressora status cadeia de caracteres de valor a ser definida. Use esse membro se não houver nenhum valor de status adequado entre aqueles listados para dwStatus.

dwSeverity

A gravidade da porta status valor.

Esse membro pode ser um dos valores a seguir.

Valor Significado
PORT_STATUS_TYPE_ERROR O valor status da porta indica um erro.
PORT_STATUS_TYPE_WARNING O valor status porta é um aviso.
PORT_STATUS_TYPE_INFO O valor de status da porta é informativo.

Comentários

Quando você define uma porta da impressora status valor com o valor de severidade PORT_STATUS_TYPE_ERROR, o spooler de impressão para de enviar trabalhos para a porta. O spooler de impressão não retoma o envio de trabalhos para a porta até que outra chamada setPort seja feita para limpar o status.

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
 _PORT_INFO_3W (Unicode) e _PORT_INFO_3A (ANSI)

Confira também

Impressão

Estruturas de API do Spooler de Impressão

SetPort