EngGetPrinter-Funktion (winddi.h)
Die EngGetPrinter-Funktion ruft Informationen zum angegebenen Drucker ab.
Syntax
ENGAPI BOOL EngGetPrinter(
[in] HANDLE hPrinter,
[in] DWORD dwLevel,
[out, optional] LPBYTE pPrinter,
[in] DWORD cbBuf,
[out] LPDWORD pcbNeeded
);
Parameter
[in] hPrinter
Handle an den Drucker, für den Daten abgerufen werden sollen. Dies ist das Handle, das als hDriver-Parameter von DrvEnablePDEV übergeben wird.
[in] dwLevel
Gibt die Version der Struktur an, auf die pPrinter zeigt. Dieser Parameter kann einen der folgenden Werte aufweisen:
| Wert | Über pPrinter zurückgegebene Struktur |
|---|---|
| 1 | PRINTER_INFO_1 |
| 2 | PRINTER_INFO_2 |
| 3 | PRINTER_INFO_3 |
| 4 | PRINTER_INFO_4 |
| 5 | PRINTER_INFO_5 |
[out, optional] pPrinter
Zeiger auf den Speicherpuffer, in den die durch dwLevel identifizierte Druckerinformationsstruktur geladen wird.
[in] cbBuf
Gibt die Größe des Speicherpuffers in Bytes an, auf den pPrinter verweist.
[out] pcbNeeded
Zeiger auf einen Speicherort im Arbeitsspeicher, der die Anzahl der kopierten Bytes empfängt, wenn die Funktion erfolgreich ist, oder die Anzahl der erforderlichen Bytes, wenn cbBuf zu klein ist.
Rückgabewert
EngGetPrinter gibt BEI Erfolg TRUE zurück. Andernfalls wird ein Fehler protokolliert und FALSE zurückgegeben. Rufen Sie EngGetLastError auf, um Fehlerinformationen zu erhalten.
Hinweise
Die PRINTER_INFO_X-Strukturen sind in der Microsoft Windows SDK-Dokumentation definiert.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |