ScheduleJob-Funktion
Die ScheduleJob-Funktion fordert an, dass der Druckspooler einen angegebenen Druckauftrag für das Drucken geplant.
Syntax
BOOL ScheduleJob(
_In_ HANDLE hPrinter,
_In_ DWORD dwJobID
);
Parameter
-
hPrinter [ In]
-
Ein Handle für den Drucker für den Druckauftrag. Dies muss ein lokaler Drucker sein, der als Spooldrucker konfiguriert ist. Wenn hPrinter ein Handle für eine Remotedruckerverbindung ist oder der Drucker für den direkten Druck konfiguriert ist, schlägt die ScheduleJob-Funktion fehl. Verwenden Sie die OpenPrinter- oder AddPrinter-Funktion, um einen Druckerhandpunkt abzurufen.
hPrinter muss dasselbe Druckerhandle sein, das im Aufruf von AddJob angegeben wurde, der die DwJobID-Druckauftrags-ID erhalten hat.
-
dwJobID [ In]
-
Der druckauftrag, der geplant werden soll. Sie erhalten diese Druckauftrags-ID, indem Sie die AddJob-Funktion aufrufen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich 0 (null).
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu kommen, dass die Anwendung nicht reagiert.
Sie müssen die AddJob-Funktion erfolgreich aufrufen, bevor Sie die ScheduleJob-Funktion aufrufen. AddJob erhält den Druckauftragsbezeichner, den Sie als dwJobID an ScheduleJob übergeben. Beide Aufrufe müssen den gleichen Wert für hPrinter verwenden.
Die ScheduleJob-Funktion sucht nach einer gültigen Spooldatei. Wenn eine ungültige Spooldatei oder leer ist, löscht ScheduleJob sowohl die Spooldatei als auch den entsprechenden Druckauftragseintrag im Druckspooler.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|