struttura PRINTER_INFO_7

  • Articolo

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