Fonction EngSetPrinterData (winddi.h)
La fonction EngSetPrinterData est obsolète dans Windows 2000 et versions ultérieures.
Dans les versions antérieures de Windows EngSetPrinterData définit les données de configuration de l’imprimante spécifiée.
Syntaxe
ENGAPI DWORD EngSetPrinterData(
[in] HANDLE hPrinter,
[in] LPWSTR pType,
[in] DWORD dwType,
[in] LPBYTE lpbPrinterData,
[in] DWORD cjPrinterData
);
Paramètres
[in] hPrinter
Gérez l’imprimante pour laquelle les données de configuration doivent être définies. Il s’agit du handle qui est passé en tant que paramètre hDriver de DrvEnablePDEV. Consultez Remarques.
[in] pType
Pointeur vers une chaîne terminée par null qui identifie les données à définir.
[in] dwType
Indicateur qui spécifie le type d’informations à définir. Ce paramètre peut être l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
| REG_BINARY | Données binaires dans tout formulaire. |
| REG_DWORD | Nombre 32 bits. |
| REG_DWORD_BIG_ENDIAN | Nombre 32 bits au format big-endian, ce qui signifie que l’octet le plus significatif d’un mot est l’octet d’ordre inférieur. |
| REG_DWORD_LITTLE_ENDIAN | Nombre 32 bits au format little endian (identique à REG_DWORD), ce qui signifie que l’octet le plus significatif d’un mot est l’octet d’ordre supérieur |
| REG_EXPAND_SZ | Chaîne terminée par null qui contient des références non expirées à des variables d’environnement (par exemple, « %PATH% »). Il s’agit d’une chaîne Unicode ou ANSI selon que les fonctions Unicode ou ANSI sont utilisées. |
| REG_LINK | Lien symbolique Unicode. |
| REG_MULTI_SZ | Tableau de chaînes terminées par deux caractères nuls. |
| REG_NONE | Aucun type valeur défini. |
| REG_RESOURCE_LIST | Liste des ressources de pilote de périphérique. |
| REG_SZ | Chaîne se terminant par une valeur null. Il s’agit d’une chaîne Unicode ou ANSI selon que vous utilisez les fonctions Unicode ou ANSI. |
[in] lpbPrinterData
Pointeur vers les données de configuration de l’imprimante à définir. Le type de données vers est déterminé par dwType.
[in] cjPrinterData
Spécifie la taille, en octets, de lpbPrinterData.
Valeur retournée
EngSetPrinterData retourne le dernier message d’erreur enregistré.
Remarques
À compter de Microsoft Windows 2000, cette fonction est obsolète. Les descripteurs utilisés dans les appels aux fonctions EngSetPrinterData et DrvEnablePDEV ont des droits d’accès différents ; par conséquent, ces fonctions ne fonctionnent plus ensemble. Le paramètre hDriver utilisé dans les appels à la fonction DrvEnablePDEV est ouvert avec le droit d’accès PRINTER_ACCESS_USE. En revanche, le paramètre hPrinter utilisé dans les appels à la fonction EngSetPrinterData doit avoir été ouvert avec le droit d’accès PRINTER_ALL_ACCESS. Par conséquent, il n’existe aucun moyen pour un pilote d’imprimante en mode noyau (le seul type de pilote d’imprimante pouvant appeler EngSetPrinterData) d’utiliser EngSetPrinterData pour écrire des informations sur une imprimante dans le Registre.
Pour plus d’informations sur les droits d’accès à l’imprimante, consultez la structure PRINTER_DEFAULTS (décrite dans la documentation du SDK Windows).
Configuration requise
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |