Fonction EngGetPrinter (winddi.h)
La fonction EngGetPrinter récupère des informations sur l’imprimante spécifiée.
Syntaxe
ENGAPI BOOL EngGetPrinter(
[in] HANDLE hPrinter,
[in] DWORD dwLevel,
[out, optional] LPBYTE pPrinter,
[in] DWORD cbBuf,
[out] LPDWORD pcbNeeded
);
Paramètres
[in] hPrinter
Gérer sur l’imprimante pour laquelle les données doivent être récupérées. Il s’agit du handle passé en tant que paramètre hDriver de DrvEnablePDEV.
[in] dwLevel
Spécifie la version de la structure vers laquelle pPrinter pointe. Ce paramètre peut avoir l’une des valeurs suivantes :
| Valeur | Structure retournée via pPrinter |
|---|---|
| 1 | PRINTER_INFO_1 |
| 2 | PRINTER_INFO_2 |
| 3 | PRINTER_INFO_3 |
| 4 | PRINTER_INFO_4 |
| 5 | PRINTER_INFO_5 |
[out, optional] pPrinter
Pointeur vers la mémoire tampon dans laquelle la structure d’informations d’imprimante, identifiée par dwLevel, est chargée.
[in] cbBuf
Spécifie la taille, en octets, de la mémoire tampon pointée par pPrinter.
[out] pcbNeeded
Pointeur vers un emplacement de mémoire qui reçoit le nombre d’octets copiés si la fonction réussit, ou le nombre d’octets requis si cbBuf est trop petit.
Valeur retournée
EngGetPrinter retourne TRUE en cas de réussite ; sinon, il consigne une erreur et retourne FALSE. Pour obtenir des informations sur l’erreur, appelez EngGetLastError.
Remarques
Les structures PRINTER_INFO_X sont définies dans la documentation Microsoft Windows SDK.
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 |