PRINTER_NOTIFY_INFO_DATA Struktur
Die PRINTER_NOTIFY_INFO_DATA-Struktur identifiziert ein Auftrags- oder Druckerinformationsfeld und stellt die aktuellen Daten für dieses Feld bereit.
Die FindNextPrinterChangeNotification-Funktion gibt eine PRINTER_NOTIFY_INFO-Struktur zurück, die ein Array von PRINTER_NOTIFY_INFO_DATA-Strukturen enthält.
Syntax
typedef struct _PRINTER_NOTIFY_INFO_DATA {
WORD Type;
WORD Field;
DWORD Reserved;
DWORD Id;
union {
DWORD adwData[2];
struct {
DWORD cbBuf;
LPVOID pBuf;
} Data;
} NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;
Member
-
Typ
-
Gibt den Typ der bereitgestellten Informationen an. Dieser Member kann einer der folgenden Werte sein.
Wert Bedeutung - JOB_NOTIFY_TYPE
- 0x01
Gibt an, dass das Field-Element eine JOB_NOTIFY_FIELD_*-Konstante angibt. - PRINTER_NOTIFY_TYPE
- 0x00
Gibt an, dass das Field-Element eine PRINTER_NOTIFY_FIELD_*-Konstante angibt. -
Feld
-
Gibt das geänderte Feld an. Eine Liste der möglichen Werte finden Sie im Abschnitt Hinweise.
-
Reserved
-
Reserviert.
-
Id
-
Gibt den Auftragsbezeichner an, wenn der Type-Member JOB_NOTIFY_TYPE angibt. Wenn das Type-Element PRINTER_NOTIFY_TYPE angibt, ist dieses Element nicht definiert.
-
NotifyData
-
Eine Vereinigung von Dateninformationen basierend auf den Elementen Type und Field . Eine Beschreibung des Typs der Daten, die den einzelnen Feldern zugeordnet sind, finden Sie im Abschnitt Hinweise.
-
adwData[2]
-
Ein Array von zwei DWORD-Werten . Für Informationsfelder, die nur ein einzelnes DWORD verwenden, befinden sich die Daten in adwData [0].
-
Daten
-
-
cbBuf
-
Gibt die Größe des Puffers in Bytes an, auf den pBuf verweist.
-
pBuf
-
Zeiger auf einen Puffer, der die aktuellen Daten des Felds enthält.
-
-
Bemerkungen
Wenn das Type-Element PRINTER_NOTIFY_TYPE angibt, kann das Field-Element einer der folgenden Werte sein.
| Feld | Datentyp | Wert |
|---|---|---|
| PRINTER_NOTIFY_FIELD_SERVER_NAME | Wird nicht unterstützt. | 0x00 |
| PRINTER_NOTIFY_FIELD_PRINTER_NAME | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Druckers enthält. | 0x01 |
| PRINTER_NOTIFY_FIELD_SHARE_NAME | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Freigabepunkt für den Drucker identifiziert. | 0x02 |
| PRINTER_NOTIFY_FIELD_PORT_NAME | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Ports enthält, an dem die Druckaufträge gedruckt werden. Wenn "Druckerpooling" ausgewählt ist, handelt es sich um eine durch Trennzeichen getrennte Liste von Ports. | 0x03 |
| PRINTER_NOTIFY_FIELD_DRIVER_NAME | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Druckertreibers enthält. | 0x04 |
| PRINTER_NOTIFY_FIELD_COMMENT | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die die neue Kommentarzeichenfolge enthält. Dies ist in der Regel eine kurze Beschreibung des Druckers. | 0x05 |
| PRINTER_NOTIFY_FIELD_LOCATION | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die die neue physische Position des Druckers enthält (z. B. "Bldg. 38, Room 1164"). | 0x06 |
| PRINTER_NOTIFY_FIELD_DEVMODE | pBuf ist ein Zeiger auf eine DEVMODE-Struktur , die Standarddruckerdaten wie die Papierausrichtung und die Auflösung definiert. | 0x07 |
| PRINTER_NOTIFY_FIELD_SEPFILE | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der Datei angibt, die zum Erstellen der Trennseite verwendet wird. Diese Seite wird verwendet, um Druckaufträge zu trennen, die an den Drucker gesendet werden. | 0x08 |
| PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des vom Drucker verwendeten Druckprozessors angibt. | 0x09 |
| PRINTER_NOTIFY_FIELD_PARAMETERS | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die die Standardparameter des Druckprozessors angibt. | 0x0A |
| PRINTER_NOTIFY_FIELD_DATATYPE | pBuf ist ein Zeiger auf eine NULL-endende Zeichenfolge, die den Datentyp angibt, der zum Aufzeichnen des Druckauftrags verwendet wird. | 0x0B |
| PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR | pBuf ist ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur für den Drucker. Der Zeiger kann NULL sein, wenn kein Sicherheitsdeskriptor vorhanden ist. | 0x0C |
| PRINTER_NOTIFY_FIELD_ATTRIBUTES |
adwData [0] gibt die Druckerattribute an, bei denen es sich um einen der folgenden Werte handeln kann:
PRINTER_ATTRIBUTE_DIRECT PRINTER_ATTRIBUTE_DEFAULT PRINTER_ATTRIBUTE_SHARED |
0x0D |
| PRINTER_NOTIFY_FIELD_PRIORITY | adwData [0] gibt einen Prioritätswert an, den der Spooler zum Weiterleiten von Druckaufträgen verwendet. | 0x0E |
| PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY | adwData [0] gibt den Standardwert an, der jedem Druckauftrag zugewiesen ist. | 0x0F |
| PRINTER_NOTIFY_FIELD_START_TIME | adwData [0] gibt den frühesten Zeitpunkt an, zu dem der Drucker einen Auftrag druckt. (Dieser Wert wird in Minuten angegeben, die seit 12:00 Uhr verstrichen sind.) | 0x10 |
| PRINTER_NOTIFY_FIELD_UNTIL_TIME | adwData [0] gibt den letzten Zeitpunkt an, zu dem der Drucker einen Auftrag druckt. (Dieser Wert wird in Minuten angegeben, die seit 12:00 Uhr verstrichen sind.) | 0x11 |
| PRINTER_NOTIFY_FIELD_STATUS | adwData [0] gibt den Drucker status an. Eine Liste der möglichen Werte finden Sie in der PRINTER_INFO_2-Struktur . | 0x12 |
| PRINTER_NOTIFY_FIELD_STATUS_STRING | Wird nicht unterstützt. | 0x13 |
| PRINTER_NOTIFY_FIELD_CJOBS | adwData [0] gibt die Anzahl der Druckaufträge an, die für den Drucker in die Warteschlange gestellt wurden. | 0x14 |
| PRINTER_NOTIFY_FIELD_AVERAGE_PPM | adwData [0] gibt die durchschnittliche Anzahl der Seiten pro Minute an, die auf dem Drucker gedruckt wurden. | 0x15 |
| PRINTER_NOTIFY_FIELD_TOTAL_PAGES | Wird nicht unterstützt. | 0x16 |
| PRINTER_NOTIFY_FIELD_PAGES_PRINTED | Wird nicht unterstützt. | 0x17 |
| PRINTER_NOTIFY_FIELD_TOTAL_BYTES | Wird nicht unterstützt. | 0x18 |
| PRINTER_NOTIFY_FIELD_BYTES_PRINTED | Wird nicht unterstützt. | 0x19 |
| PRINTER_NOTIFY_FIELD_OBJECT_GUID | Dies wird festgelegt, wenn sich die Objekt-GUID ändert. | 0x1A |
| PRINTER_NOTIFY_FIELD_FRIENDLY_NAME | Dies wird festgelegt, wenn die Druckerverbindung umbenannt wird. | 0x1B |
Wenn das Type-Element JOB_NOTIFY_TYPE angibt, kann das Field-Element einer der folgenden Werte sein.
| Feld | Datentyp | Wert |
|---|---|---|
| JOB_NOTIFY_FIELD_PRINTER_NAME | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Druckers enthält, für den der Auftrag gespoolt wird. | 0x00 |
| JOB_NOTIFY_FIELD_MACHINE_NAME | pBuf ist ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Computers angibt, der den Druckauftrag erstellt hat. | 0x01 |
| JOB_NOTIFY_FIELD_PORT_NAME | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die die Ports identifiziert, die zum Übertragen von Daten an den Drucker verwendet werden. Wenn ein Drucker mit mehreren Ports verbunden ist, werden die Namen der Ports durch Kommas getrennt (z. B. "LPT1:,LPT2:,LPT3:"). | 0x02 |
| JOB_NOTIFY_FIELD_USER_NAME | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Benutzers angibt, der den Druckauftrag gesendet hat. | 0x03 |
| JOB_NOTIFY_FIELD_NOTIFY_NAME | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Benutzers angibt, der benachrichtigt werden soll, wenn der Auftrag gedruckt wurde oder wenn beim Drucken des Auftrags ein Fehler auftritt. | 0x04 |
| JOB_NOTIFY_FIELD_DATATYPE | pBuf ist ein Zeiger auf eine NULL-Zeichenfolge, die den Typ der Daten angibt, die zum Aufzeichnen des Druckauftrags verwendet werden. | 0x05 |
| JOB_NOTIFY_FIELD_PRINT_PROCESSOR | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Druckprozessors angibt, der zum Drucken des Auftrags verwendet werden soll. | 0x06 |
| JOB_NOTIFY_FIELD_PARAMETERS | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die Druckprozessorparameter angibt. | 0x07 |
| JOB_NOTIFY_FIELD_DRIVER_NAME | pBuf ist ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Druckertreibers angibt, der zum Verarbeiten des Druckauftrags verwendet werden soll. | 0x08 |
| JOB_NOTIFY_FIELD_DEVMODE | pBuf ist ein Zeiger auf eine DEVMODE-Struktur , die Geräteinitialisierungs- und Umgebungsdaten für den Druckertreiber enthält. | 0x09 |
| JOB_NOTIFY_FIELD_STATUS | adwData [0] gibt den Auftrag status an. Eine Liste der möglichen Werte finden Sie in der struktur JOB_INFO_2 . | 0x0A |
| JOB_NOTIFY_FIELD_STATUS_STRING | pBuf ist ein Zeiger auf eine null-beendete Zeichenfolge, die die status des Druckauftrags angibt. | 0x0B |
| JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR | Wird nicht unterstützt. | 0x0C |
| JOB_NOTIFY_FIELD_DOCUMENT | pBuf ist ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Druckauftrags angibt (z. B. "MS-WORD: Review.doc"). | 0x0D |
| JOB_NOTIFY_FIELD_PRIORITY | adwData [0] gibt die Auftragspriorität an. | 0x0E |
| JOB_NOTIFY_FIELD_POSITION | adwData [0] gibt die Position des Auftrags in der Druckwarteschlange an. | 0x0F |
| JOB_NOTIFY_FIELD_SUBMITTED | pBuf ist ein Zeiger auf eine SYSTEMTIME-Struktur , die den Zeitpunkt angibt, zu dem der Auftrag übermittelt wurde. | 0x10 |
| JOB_NOTIFY_FIELD_START_TIME | adwData [0] gibt den frühesten Zeitpunkt an, zu dem der Auftrag gedruckt werden kann. (Dieser Wert wird in Minuten angegeben, die seit 12:00 Uhr verstrichen sind.) | 0x11 |
| JOB_NOTIFY_FIELD_UNTIL_TIME | adwData [0] gibt den zeitpunkt an, zu dem der Auftrag gedruckt werden kann. (Dieser Wert wird in Minuten angegeben, die seit 12:00 Uhr verstrichen sind.) | 0x12 |
| JOB_NOTIFY_FIELD_TIME | adwData [0] gibt die Gesamtzeit in Sekunden an, die seit Beginn des Druckvorgangs verstrichen ist. | 0x13 |
| JOB_NOTIFY_FIELD_TOTAL_PAGES | adwData [0] gibt die Größe des Auftrags in Seiten an. | 0x14 |
| JOB_NOTIFY_FIELD_PAGES_PRINTED | adwData [0] gibt die Anzahl der Seiten an, die gedruckt wurden. | 0x15 |
| JOB_NOTIFY_FIELD_TOTAL_BYTES | adwData [0] gibt die Größe des Auftrags in Bytes an. | 0x16 |
| JOB_NOTIFY_FIELD_BYTES_PRINTED | adwData [0] gibt die Anzahl der Bytes an, die für diesen Auftrag gedruckt wurden. Für dieses Feld wird das Änderungsbenachrichtigungsobjekt signalisiert, wenn Bytes an den Drucker gesendet werden. | 0x17 |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|