Funktion APUGetPrinterStatus()

Ermittelt den letzten Status des Windows-Druckers, der von der angegebenen Instanz verwendet wird.

Kategorie

Anzeigen

Syntax

[Result=] APUGetPrinterStatus(iInstance, iSelector, iTagStatus);

Argumente

iInstance

Die gewünschte Alarmdrucker-Instanz (0 bis 15).

iSelector

Integer-Wert mit den folgenden Optionen:

0 = ermitteln, ob ein Fehler vorliegt

1 = ermitteln, ob der Drucker kein Papier mehr hat

2 = ermitteln, ob der Drucker offline ist

3 = ermitteln, ob ein Speicherüberlauf beim Drucker vorliegt

iTagStatus

Die Integer-/Real-Variable, in die der angegebene Statuswert geschrieben werden soll.

Anmerkungen

Der Status des Druckers wird an die Integer- oder Real-Variable übergeben, die als Parameter iTagStatus angegeben ist. Die Ergebnisse sind nur dann aktuell, wenn eine Abfrage läuft und bereits ein Alarm ausgedruckt wurde. Der Status wird in der Regel erstmals ermittelt, wenn der Drucker geöffnet wird, und dann fortlaufend aktualisiert, wenn neue Alarmzeilen gedruckt werden.

Die Statusinformationen werden gemäß der Microsoft- bzw. Windows-Treiberstandards vom Druckertreiber angefordert. Da nicht alle Druckerhersteller diese Standards befolgen, kann nicht gewährleistet werden, dass alle Drucker die genannten Statusinformationen auch tatsächlich zurückmelden.

Gibt einen Fehler-/Ergebniscode des Typs Integer zurück.

Beispiel

In die Integer-Variable PrtStat wird ein Wert geschrieben, der besagt, ob der Drucker für die Instanz Nr. 5 gerade offline ist.

Status = APUGetPrinterStatus(5, 2, PrtStat);

Siehe auch

APUGetPrinterName()