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