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. Siehe den folgenden Abschnitt "Hinweise".
pDevmode
Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW--Struktur. Siehe den folgenden Abschnitt "Hinweise".
pwszDocName
Vom Aufrufer bereitgestellter Zeiger auf den Dokumentnamen des Druckauftrags. Siehe den folgenden Abschnitt "Hinweise".
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Spooldateihandle zurück. Andernfalls gibt die Funktion NULL-zurück.
Bemerkungen
Die GdiGetSpoolFileHandle--Funktion wird von gdi32.dll für die Verwendung innerhalb der PrintDocumentOnPrintProcessor--Funktion eines Druckprozessors exportiert.
Wenn ein Druckprozessor GdiGetSpoolFileHandleaufruft, sollte er Argumente bereitstellen, wie in der folgenden Tabelle dargestellt.
| Parameter | Argument |
|---|---|
| pwszPrinterName | Zeigen Sie auf den Druckernamen, der vom OpenPrintProcessor Funktion des Druckprozessors empfangen wird. |
| pDevmode- | Zeiger auf die DEVMODEW- Struktur in der PRINTPROCESSOROPENDATA- Struktur, die vom OpenPrintProcessor-Funktion des Druckprozessors empfangen wird. |
| pwszDocName | Dokumentnamezeiger, der vom PrintDocumentOnPrintProcessor-Funktion des Druckprozessors empfangen wird. |
Ein Druckprozessor muss die GdiGetSpoolFileHandle--Funktion aufrufen, bevor andere GDI-Druckfunktionen aufgerufen werden, da der 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 die Zeichnung zu erstellen. Der Druckprozessor kann das Handle des Gerätekontexts abrufen, indem GdiGetDC-aufgerufen wird.
Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | winppi.h (include Winppi.h) |
| Library | Gdi32.Lib |
| DLL- | Gdi32.dll |