GdiGetSpoolFileHandle-Funktion (winppi.h)
Die GdiGetSpoolFileHandle-Funktion gibt ein Handle an die EMF-Datei eines Druckauftrags zurück.
Syntax
HANDLE GdiGetSpoolFileHandle(
LPWSTR pwszPrinterName,
LPDEVMODEW pDevmode,
LPWSTR pwszDocName
);
Parameter
pwszPrinterName
Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die den Namen des Zieldruckers darstellt. Weitere Informationen finden Sie im abschnitt "Hinweise".
pDevmode
Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW-Struktur . Weitere Informationen finden Sie im abschnitt "Hinweise".
pwszDocName
Vom Aufrufer bereitgestellter Zeiger auf den Dokumentnamen des Druckauftrags. Weitere Informationen finden Sie im abschnitt "Hinweise".
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Spooldateihandle zurück. Andernfalls gibt die Funktion NULL zurück.
Hinweise
Die GdiGetSpoolFileHandle-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.
Wenn ein Druckprozessor GdiGetSpoolFileHandle aufruft, sollte er Argumente bereitstellen, wie in der folgenden Tabelle dargestellt.
| Parameter | Argument |
|---|---|
| pwszPrinterName | Zeiger auf den Druckernamen, der von der OpenPrintProcessor-Funktion des Druckprozessors empfangen wird. |
| pDevmode | Zeiger auf die DEVMODEW-Struktur in der PRINTPROCESSOROPENDATA-Struktur , die von der OpenPrintProcessor-Funktion des Druckprozessors empfangen wird. |
| pwszDocName | Dokumentnamezeiger, der von der PrintDocumentOnPrintProcessor-Funktion des Druckprozessors empfangen wird. |
Ein Druckprozessor muss die GdiGetSpoolFileHandle-Funktion aufrufen, bevor andere GDI-Druckfunktionen aufgerufen werden, da das zurückgegebene Handle an die anderen Funktionen übergeben werden muss. Die Funktion ruft OpenPrinter auf, um eine Verbindung mit dem Drucker zu öffnen, und CreateDC, um einen Gerätekontext für das Zeichnen zu erstellen. Der Druckprozessor kann das Handle des Gerätekontexts abrufen, indem er GdiGetDC aufruft.
Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | winppi.h (winppi.h einschließen) |
| Bibliothek | Gdi32.Lib |
| DLL | Gdi32.dll |