EngSetPrinterData-Funktion (winddi.h)
Die EngSetPrinterData-Funktion ist in Windows 2000 und höher veraltet.
In früheren Versionen von Windows EngSetPrinterData werden die Konfigurationsdaten für den angegebenen Drucker festgelegt.
Syntax
ENGAPI DWORD EngSetPrinterData(
[in] HANDLE hPrinter,
[in] LPWSTR pType,
[in] DWORD dwType,
[in] LPBYTE lpbPrinterData,
[in] DWORD cjPrinterData
);
Parameter
[in] hPrinter
Handle an den Drucker, für den Konfigurationsdaten festgelegt werden sollen. Dies ist das Handle, das als hDriver-Parameter von DrvEnablePDEV übergeben wird. Siehe Hinweise.
[in] pType
Zeiger auf eine NULL-beendete Zeichenfolge, die die festzulegenden Daten identifiziert.
[in] dwType
Ist ein Flag, das den Typ der festzulegenden Informationen angibt. Dieser Parameter kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
| REG_BINARY | Binärdaten in beliebiger Form. |
| REG_DWORD | Eine 32-Bit-Zahl. |
| REG_DWORD_BIG_ENDIAN | Eine 32-Bit-Zahl im Big-End-Format, was bedeutet, dass das wichtigste Byte eines Wortes das Byte mit niedriger Ordnung ist. |
| REG_DWORD_LITTLE_ENDIAN | Eine 32-Bit-Zahl im Little-Endian-Format (identisch mit REG_DWORD), was bedeutet, dass das wichtigste Byte eines Wortes das Byte hoher Ordnung ist. |
| REG_EXPAND_SZ | Eine NULL-Zeichenfolge, die nicht erweitere Verweise auf Umgebungsvariablen enthält (z. B. "%PATH%"). Es handelt sich um eine Unicode- oder ANSI-Zeichenfolge, je nachdem, ob Unicode- oder ANSI-Funktionen verwendet werden. |
| REG_LINK | Eine symbolische Unicode-Verknüpfung. |
| REG_MULTI_SZ | Ein Array von auf NULL endenden Zeichenfolgen, das auf zwei NULL-Zeichen endet. |
| REG_NONE | Kein definierter Werttyp. |
| REG_RESOURCE_LIST | Eine Gerätetreiberressourcenliste. |
| REG_SZ | Eine NULL-terminierte Zeichenfolge. Es handelt sich um eine Unicode- oder ANSI-Zeichenfolge, je nachdem, ob Sie die Unicode- oder ANSI-Funktionen verwenden. |
[in] lpbPrinterData
Zeiger auf die festzulegenden Druckerkonfigurationsdaten. Der Typ der Daten, auf die verwiesen wird, wird durch dwType bestimmt.
[in] cjPrinterData
Gibt die Größe von lpbPrinterData in Bytes an.
Rückgabewert
EngSetPrinterData gibt die zuletzt protokollierte Fehlermeldung zurück.
Hinweise
Ab Microsoft Windows 2000 ist diese Funktion veraltet. Die in Aufrufen der Funktionen EngSetPrinterData und DrvEnablePDEV verwendeten Handles verfügen über unterschiedliche Zugriffsrechte. daher funktionieren diese Funktionen nicht mehr zusammen. Der hDriver-Parameter , der in Aufrufen der DrvEnablePDEV-Funktion verwendet wird, wird mit dem zugriffsrecht PRINTER_ACCESS_USE geöffnet. Im Gegensatz dazu muss der hPrinter-Parameter , der in Aufrufen der EngSetPrinterData-Funktion verwendet wird, mit dem zugriffsrecht PRINTER_ALL_ACCESS geöffnet worden sein. Daher gibt es keine Möglichkeit für einen Druckertreiber im Kernelmodus (der einzige Druckertreibertyp, der EngSetPrinterData aufrufen kann) EngSetPrinterData zu verwenden, um Informationen zu einem Drucker in die Registrierung zu schreiben.
Weitere Informationen zu Druckerzugriffsrechten finden Sie in der PRINTER_DEFAULTS-Struktur (in der Windows SDK-Dokumentation beschrieben).
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 |