Funzione EngSetPrinterData (winddi.h)

La funzione EngSetPrinterData è obsoleta in Windows 2000 e versioni successive.

Nelle versioni precedenti di Windows EngSetPrinterData imposta i dati di configurazione per la stampante specificata.

Sintassi

ENGAPI DWORD EngSetPrinterData(
  [in] HANDLE hPrinter,
  [in] LPWSTR pType,
  [in] DWORD  dwType,
  [in] LPBYTE lpbPrinterData,
  [in] DWORD  cjPrinterData
);

Parametri

[in] hPrinter

Gestire la stampante per cui impostare i dati di configurazione. Si tratta dell'handle passato come parametro hDriver di DrvEnablePDEV. Vedere Osservazioni.

[in] pType

Puntatore a una stringa con terminazione null che identifica i dati da impostare.

[in] dwType

Flag che specifica il tipo di informazioni da impostare. Questo parametro può essere uno dei valori seguenti:

Valore	Significato
REG_BINARY	Dati binari in qualsiasi forma.
REG_DWORD	Numero a 32 bit.
REG_DWORD_BIG_ENDIAN	Un numero a 32 bit in formato big-endian, ovvero il byte più significativo di una parola è il byte a basso ordine.
REG_DWORD_LITTLE_ENDIAN	Un numero a 32 bit in formato little-endian (uguale a REG_DWORD), significa che il byte più significativo di una parola è il byte di ordine elevato
REG_EXPAND_SZ	Stringa con terminazione null che contiene riferimenti non esplorati alle variabili di ambiente, ad esempio "%PATH%"). Sarà una stringa Unicode o ANSI a seconda che vengano usate funzioni Unicode o ANSI.
REG_LINK	Collegamento simbolico Unicode.
REG_MULTI_SZ	Matrice di stringhe con terminazione Null, terminate da due caratteri Null.
REG_NONE	Nessun tipo di valore definito.
REG_RESOURCE_LIST	Elenco di risorse del driver di dispositivo.
REG_SZ	Specifica una stringa che termina con Null. Sarà una stringa Unicode o ANSI a seconda che si usino le funzioni Unicode o ANSI.

[in] lpbPrinterData

Puntatore ai dati di configurazione della stampante da impostare. Il tipo di dati a cui punta è determinato da dwType.

[in] cjPrinterData

Specifica le dimensioni, in byte, di lpbPrinterData.

Valore restituito

EngSetPrinterData restituisce l'ultimo messaggio di errore registrato.

Commenti

A partire da Microsoft Windows 2000, questa funzione è obsoleta. Gli handle usati nelle chiamate alle funzioni EngSetPrinterData e DrvEnablePDEV hanno diritti di accesso diversi; di conseguenza queste funzioni non funzionano più insieme. Il parametro hDriver usato nelle chiamate alla funzione DrvEnablePDEV viene aperto con il diritto di accesso PRINTER_ACCESS_USE. Al contrario, il parametro hPrinter usato nelle chiamate alla funzione EngSetPrinterData deve essere stato aperto con il diritto di accesso PRINTER_ALL_ACCESS. Di conseguenza, non esiste alcun modo per un driver della stampante in modalità kernel (l'unico tipo di driver di stampante che può chiamare EngSetPrinterData) per usare EngSetPrinterData per scrivere informazioni su una stampante nel Registro di sistema.

Per altre informazioni sui diritti di accesso alla stampante, vedere la struttura PRINTER_DEFAULTS (descritta nella documentazione di Windows SDK).

Requisiti

Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys

Vedi anche

DrvEnablePDEV

EngGetPrinterData