PRINTER_INFO_4 struttura

La struttura PRINTER_INFO_4 specifica informazioni generali sulla stampante.

La struttura può essere usata per recuperare informazioni minime sulla stampante in una chiamata a EnumPrinters. Tale chiamata è un modo rapido e semplice per recuperare i nomi e gli attributi di tutte le stampanti installate in locale in un sistema e tutte le connessioni di stampante remote stabilite da un utente.

Sintassi

typedef struct _PRINTER_INFO_4 {
  LPTSTR pPrinterName;
  LPTSTR pServerName;
  DWORD  Attributes;
} PRINTER_INFO_4, *PPRINTER_INFO_4;

Members

pPrinterName

Puntatore a una stringa con terminazione null che specifica il nome della stampante (locale o remoto).

pServerName

Puntatore a una stringa con terminazione null che corrisponde al nome del server.

Attributes (Attributi)

Specifica informazioni sui dati restituiti.

Valore	Significato
PRINTER_ATTRIBUTE_LOCAL	La stampante è una stampante locale.
PRINTER_ATTRIBUTE_NETWORK	La stampante è una stampante remota.

Commenti

La struttura PRINTER_INFO_4 offre un modo semplice ed estremamente rapido per recuperare i nomi delle stampanti installate in un computer locale, nonché le connessioni remote stabilite da un utente. Quando EnumPrinters viene chiamato con una struttura di dati PRINTER_INFO_4 , tale funzione esegue una query sul Registro di sistema per le informazioni specificate, quindi restituisce immediatamente. Ciò è diverso dal comportamento di EnumPrinters quando viene chiamato con altri livelli di PRINTER_INFO_xxx strutture di dati. In particolare, quando EnumPrinters viene chiamato con una struttura di dati di livello 2 (PRINTER_INFO_2 ), esegue una chiamata OpenPrinter in ogni connessione remota. Se una connessione remota è inattiva, se il server remoto non esiste più o se la stampante remota non esiste più, la funzione deve attendere il timeout di RPC e quindi non riuscire la chiamata OpenPrinter . L'operazione può richiedere un po' di tempo. Il passaggio di una struttura PRINTER_INFO_4 consente a un'applicazione di recuperare un minimo di informazioni necessarie; se si desidera ottenere informazioni più dettagliate, è possibile effettuare una chiamata successiva AnumPrinter livello 2.

Gli attributi possono contenere anche valori definiti nel campo Attributi di PRINTER_INFO_2.

Alcune configurazioni della stampante, ad esempio le connessioni della stampante ad alcuni server di stampa non basati su Windows, potrebbero restituire sia PRINTER_ATTRIBUTE_LOCAL che PRINTER_ATTRIBUTE_NETWORK.

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_4W (Unicode) e _PRINTER_INFO_4A (ANSI)

Vedi anche

Stampa

Stampare strutture API Spooler

GetPrinter

Enumprinters

OpenPrinter

PRINTER_INFO_1

PRINTER_INFO_2

PRINTER_INFO_3