PRINTER_INFO_7構造体

PRINTER_INFO_7構造体は、ディレクトリ サービスのプリンター情報を指定します。 この構造体を SetPrinter 関数と共に使用して、プリンターのデータをディレクトリ サービス (DS) に発行するか、プリンターの発行済みデータを DS から更新または削除します。 この構造体を GetPrinter 関数と共に使用して、プリンターが DS に発行されているかどうかを判断します。

構文

typedef struct _PRINTER_INFO_7 {
  LPTSTR pszObjectGUID;
  DWORD  dwAction;
} PRINTER_INFO_7, *PPRINTER_INFO_7;

メンバー

pszObjectGUID

発行されたプリンターに関連付けられているディレクトリ サービス印刷キュー オブジェクトの GUID を含む null で終わる文字列へのポインター。 GetPrinter 関数を使用して、この GUID を取得します。

SetPrinter を呼び出す前に、pszObjectGUID を NULL に設定します。

dwAction

SetPrinter 関数が実行するアクションを示します。 GetPrinter 関数の場合、このメンバーは、指定したプリンターが発行されているかどうかを示します。 このメンバーには、次の値の組み合わせを指定できます。

値	説明
DSPRINT_PENDING 0x80000000	GetPrinter: SetPrinter 呼び出しによって開始された発行または発行解除操作をシステムが完了しようとしていることを示します。 SetPrinter: この値は無効です。
DSPRINT_PUBLISH 0x00000001	SetPrinter: プリンターのデータを DS に発行します。 GetPrinter: プリンターが発行されていることを示します。
DSPRINT_REPUBLISH 0x00000008	SetPrinter: プリンターの DS データは発行解除され、発行されたプリンター内のすべてのプロパティが更新されて、再度発行されます。 再発行では、発行されたプリンターの GUID も変更されます。 GetPrinter: この値を返しません。
DSPRINT_UNPUBLISH 0x00000004	SetPrinter: プリンターの発行済みデータを DS から削除します。 GetPrinter: プリンターが発行されていないことを示します。
DSPRINT_UPDATE 0x00000002	SetPrinter: DS でプリンターのパブリッシュされたデータを更新します。 GetPrinter: この値を返しません。

解説

PRINTER_INFO_7構造体は、プリンター情報をディレクトリ サービスに発行するために SetPrinter 呼び出しで使用されます。 パブリッシュされたデータには、 SetPrinterDataEx によって作成されたSPLDS_SPOOLER_KEY、SPLDS_DRIVER_KEY、またはSPLDS_USER_KEYキーの下にある指定されたプリンターのすべての値とデータが含まれます。

SetPrinter の場合、pszObjectGUID を NULL に設定する必要があります。 GetPrinter の場合、pszObjectGUID は、発行されたプリンターに関連付けられているディレクトリ サービス印刷キュー オブジェクトの GUID を返します。 この GUID を Active Directory Services Interface (ADSI) メソッドと共に使用して、プリンターの発行済みデータを取得できます。 ただし、パブリッシュされたデータを取得するために推奨される方法は、 GetPrinterDataEx 関数を呼び出す方法です。

必要条件

関連項目

印刷

印刷スプーラー API 構造体