struttura PRINTER_INFO_7

Articolo
06/13/2023

La struttura PRINTER_INFO_7 specifica le informazioni sulla stampante dei servizi directory. Utilizzare questa struttura con la funzione SetPrinter per pubblicare i dati di una stampante nel servizio directory oppure per aggiornare o rimuovere i dati pubblicati di una stampante da DS. Utilizzare questa struttura con la funzione GetPrinter per determinare se una stampante viene pubblicata in DS.

Sintassi

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

Members

pszObjectGUID

Puntatore a una stringa con terminazione Null contenente il GUID dell'oggetto coda di stampa del servizio directory associato a una stampante pubblicata. Usare la funzione GetPrinter per recuperare questo GUID.

Prima di chiamare SetPrinter, impostare pszObjectGUID su NULL.

dwAction

Indica l'azione da eseguire per la funzione SetPrinter . Per la funzione GetPrinter , questo membro indica se la stampante specificata viene pubblicata. Questo membro può essere una combinazione dei valori seguenti.

Valore	Significato
DSPRINT_PENDING 0x80000000	GetPrinter: indica che il sistema sta tentando di completare un'operazione di pubblicazione o annullamento della pubblicazione avviata da una chiamata SetPrinter . SetPrinter: questo valore non è valido.
DSPRINT_PUBLISH 0x00000001	SetPrinter: pubblica i dati della stampante in DS. GetPrinter: indica che la stampante è pubblicata.
DSPRINT_REPUBLISH 0x00000008	SetPrinter: i dati DS per la stampante non vengono pubblicati e quindi pubblicati nuovamente, aggiornando tutte le proprietà nella stampante pubblicata. La ripubblicazione modifica anche il GUID della stampante pubblicata. GetPrinter: non restituisce mai questo valore.
DSPRINT_UNPUBLISH 0x00000004	SetPrinter: rimuove i dati pubblicati della stampante dal DS. GetPrinter: indica che la stampante non è pubblicata.
DSPRINT_UPDATE 0x00000002	SetPrinter: Aggiornamenti i dati pubblicati della stampante in DS. GetPrinter: non restituisce mai questo valore.

Commenti

La struttura PRINTER_INFO_7 viene utilizzata in una chiamata SetPrinter per pubblicare informazioni sulla stampante nel servizio directory. I dati pubblicati includono tutti i valori e i dati per la stampante specificata presenti nella SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY o SPLDS_USER_KEY chiavi create da SetPrinterDataEx.

Per SetPrinter, pszObjectGUID deve essere impostato su NULL. Per GetPrinter, pszObjectGUID restituisce il GUID dell'oggetto coda di stampa dei servizi directory associato a una stampante pubblicata. È possibile usare questo GUID con i metodi ADSI (Active Directory Services Interface) per recuperare i dati pubblicati per la stampante. Tuttavia, il metodo consigliato per il recupero dei dati pubblicati consiste nel chiamare la funzione GetPrinterDataEx .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Nomi Unicode e ANSI	_PRINTER_INFO_7W (Unicode) e _PRINTER_INFO_7A (ANSI)

Vedi anche

Stampa
Stampare le strutture dell'API Spooler

Condividi tramite