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

Weitere Informationen

DrvEnablePDEV

EngGetPrinterData