Función EngSetPrinterData (winddi.h)
La función EngSetPrinterData está obsoleta en Windows 2000 y versiones posteriores.
En versiones anteriores de Windows EngSetPrinterData establece los datos de configuración de la impresora especificada.
Sintaxis
ENGAPI DWORD EngSetPrinterData(
[in] HANDLE hPrinter,
[in] LPWSTR pType,
[in] DWORD dwType,
[in] LPBYTE lpbPrinterData,
[in] DWORD cjPrinterData
);
Parámetros
[in] hPrinter
Identificador de la impresora para la que se deben establecer los datos de configuración. Este es el identificador que se pasa como parámetro hDriver de DrvEnablePDEV. Vea Comentarios.
[in] pType
Puntero a una cadena terminada en null que identifica los datos que se van a establecer.
[in] dwType
Es una marca que especifica el tipo de información que se va a establecer. Este parámetro puede ser uno de los valores siguientes:
| Valor | Significado |
|---|---|
| REG_BINARY | Datos binarios en cualquier formato. |
| REG_DWORD | Número de 32 bits. |
| REG_DWORD_BIG_ENDIAN | Número de 32 bits en formato big-endian, lo que significa que el byte más significativo de una palabra es el byte de orden bajo. |
| REG_DWORD_LITTLE_ENDIAN | Número de 32 bits en formato little-endian (igual que REG_DWORD), lo que significa que el byte más significativo de una palabra es el byte de orden alto |
| REG_EXPAND_SZ | Cadena terminada en null que contiene referencias no expandidas a variables de entorno (por ejemplo, "%PATH%"). Será una cadena Unicode o ANSI dependiendo de si se usan funciones Unicode o ANSI. |
| REG_LINK | Un vínculo simbólico Unicode. |
| REG_MULTI_SZ | Una matriz de cadenas terminadas en nulo, finalizada con dos caracteres null. |
| REG_NONE | No hay ningún tipo de valor definido. |
| REG_RESOURCE_LIST | Una lista de recursos de controlador de dispositivo. |
| REG_SZ | Una cadena terminada en null. Será una cadena Unicode o ANSI dependiendo de si usa las funciones Unicode o ANSI. |
[in] lpbPrinterData
Puntero a los datos de configuración de la impresora que se van a establecer. DwType determina el tipo de datos a los que apunta dwType.
[in] cjPrinterData
Especifica el tamaño, en bytes, de lpbPrinterData.
Valor devuelto
EngSetPrinterData devuelve el último mensaje de error registrado.
Comentarios
A partir de Microsoft Windows 2000, esta función está obsoleta. Los identificadores utilizados en las llamadas a las funciones EngSetPrinterData y DrvEnablePDEV tienen diferentes derechos de acceso; por lo tanto, estas funciones ya no funcionan juntas. El parámetro hDriver usado en las llamadas a la función DrvEnablePDEV se abre con el derecho de acceso PRINTER_ACCESS_USE. Por el contrario, el parámetro hPrinter usado en las llamadas a la función EngSetPrinterData debe haberse abierto con el derecho de acceso PRINTER_ALL_ACCESS. Como resultado, no hay forma de que un controlador de impresora en modo kernel (el único tipo de controlador de impresora que pueda llamar a EngSetPrinterData) use EngSetPrinterData para escribir información sobre una impresora en el registro.
Para obtener más información sobre los derechos de acceso a la impresora, consulte la estructura de PRINTER_DEFAULTS (que se describe en la documentación de Windows SDK).
Requisitos
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |