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 |