PORT_INFO_3構造体

PORT_INFO_3構造体は、プリンターポートの状態値を指定します。

構文

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

dwStatus

新しいポートの状態の値。この値は、 pszStatus メンバーが NULL の場合にのみ使用されます。

このメンバーには、次のいずれかの値を指定できます。

値	説明
0	プリンターポートの状態をクリアします。
PORT_STATUS_OFFLINE	ポートのプリンターがオフラインです。
PORT_STATUS_PAPER_JAM	ポートのプリンターに紙詰まりがあります。
PORT_STATUS_PAPER_OUT	ポートのプリンターが紙切れです。
PORT_STATUS_OUTPUT_BIN_FULL	ポートのプリンターの出力ビンがいっぱいです。
PORT_STATUS_PAPER_PROBLEM	ポートのプリンターに紙の問題があります。
PORT_STATUS_NO_TONER	ポートのプリンターがトナー切れです。
PORT_STATUS_DOOR_OPEN	ポートのプリンターのドアが開いています。
PORT_STATUS_USER_INTERVENTION	ポートのプリンターには、ユーザーの介入が必要です。
PORT_STATUS_OUT_OF_MEMORY	ポートのプリンターがメモリ不足です。
PORT_STATUS_TONER_LOW	ポートのプリンターはトナーが少ない。
PORT_STATUS_WARMING_UP	ポートのプリンターがウォームアップしています。
PORT_STATUS_POWER_SAVE	ポートのプリンターは省電力モードです。

pszStatus

設定する新しいプリンターポートの状態値文字列へのポインター。 dwStatus の一覧に適切な状態値がない場合は、このメンバーを使用します。

dwSeverity

ポートステータス値の重大度。

このメンバーには、次のいずれかの値を指定できます。

重大度値がPORT_STATUS_TYPE_ERRORプリンターポートの状態値を設定すると、印刷スプーラーはポートへのジョブの送信を停止します。印刷スプーラーは、状態をクリアするために別の SetPort 呼び出しが行われるまで、ポートへのジョブの送信を再開しません。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	Winspool.h (Windows.h を含む)
Unicode 名と ANSI 名	_PORT_INFO_3W (Unicode) と _PORT_INFO_3A (ANSI)