Condividi tramite


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