estrutura PORT_INFO_3

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