PRINTER_INFO_4 Struktur
Die PRINTER_INFO_4-Struktur gibt allgemeine Druckerinformationen an.
Die Struktur kann verwendet werden, um minimale Druckerinformationen bei einem Aufruf von EnumPrinters abzurufen. Ein solcher Aufruf ist eine schnelle und einfache Möglichkeit, die Namen und Attribute aller lokal installierten Drucker auf einem System und alle Remotedruckerverbindungen abzurufen, die ein Benutzer eingerichtet hat.
Syntax
typedef struct _PRINTER_INFO_4 {
LPTSTR pPrinterName;
LPTSTR pServerName;
DWORD Attributes;
} PRINTER_INFO_4, *PPRINTER_INFO_4;
Member
-
pPrinterName
-
Zeiger auf eine NULL-Zeichenfolge, die den Namen des Druckers (lokal oder remote) angibt.
-
pServerName
-
Zeiger auf eine NULL-beendete Zeichenfolge, die dem Namen des Servers entspricht.
-
Attribute
-
Gibt Informationen zu den zurückgegebenen Daten an.
Wert Bedeutung PRINTER_ATTRIBUTE_LOCAL Der Drucker ist ein lokaler Drucker. PRINTER_ATTRIBUTE_NETWORK Der Drucker ist ein Remotedrucker.
Bemerkungen
Die PRINTER_INFO_4-Struktur bietet eine einfache und extrem schnelle Möglichkeit zum Abrufen der Namen der Drucker, die auf einem lokalen Computer installiert sind, sowie die Remoteverbindungen, die ein Benutzer eingerichtet hat. Wenn EnumPrinters mit einer PRINTER_INFO_4 Datenstruktur aufgerufen wird, fragt diese Funktion die Registrierung nach den angegebenen Informationen ab und gibt sofort zurück. Dies unterscheidet sich vom Verhalten von EnumPrinters , wenn sie mit anderen Ebenen von PRINTER_INFO_xxx Datenstrukturen aufgerufen werden. Insbesondere wenn EnumPrinters mit einer Datenstruktur der Ebene 2 (PRINTER_INFO_2 ) aufgerufen wird, führt es einen OpenPrinter-Aufruf für jede Remoteverbindung aus. Wenn eine Remoteverbindung nicht mehr vorhanden ist, der Remoteserver nicht mehr vorhanden ist oder der Remotedrucker nicht mehr vorhanden ist, muss die Funktion warten, bis das RPC-Timeout auftritt und folglich beim OpenPrinter-Aufruf fehlschlägt. Dies kann eine Weile dauern. Durch das Übergeben einer PRINTER_INFO_4-Struktur kann eine Anwendung ein Minimum an erforderlichen Informationen abrufen. wenn ausführlichere Informationen gewünscht werden, kann ein nachfolgender EnumPrinter Level 2-Aufruf erfolgen.
Attribute können auch Werte enthalten, die im Feld Attribute von PRINTER_INFO_2 definiert sind.
Einige Druckerkonfigurationen, z. B. Druckerverbindungen mit einigen nicht windowsbasierten Druckservern, geben möglicherweise sowohl PRINTER_ATTRIBUTE_LOCAL als auch PRINTER_ATTRIBUTE_NETWORK zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Unicode- und ANSI-Name |
_PRINTER_INFO_4W (Unicode) und _PRINTER_INFO_4A (ANSI) |