Función GetJobAttributesEx (winsplp.h)
Advertencia
A partir de Windows 10, las API que admiten proveedores de impresión de terceros están en desuso. Microsoft no recomienda ninguna inversión en proveedores de impresión de terceros. Además, en Windows 8 y productos más recientes en los que el modelo de controlador de impresión v4 está disponible, es posible que los proveedores de impresión de terceros no creen o administren colas que usan controladores de impresión v4.
La función GetJobAttributesEx de un proveedor de impresión obtiene información sobre un trabajo de impresión, incluidas las opciones de impresión de N up e reverse.
Sintaxis
BOOL GetJobAttributesEx(
[in] LPWSTR pPrinterName,
[in] LPDEVMODEW pDevmode,
[in] DWORD dwLevel,
[out] LPBYTE pAttributeInfo,
[in] DWORD nSize,
[in] DWORD dwFlags
);
Parámetros
[in] pPrinterName
Puntero proporcionado por el autor de la llamada a una cadena Unicode terminada en NULL que contiene el nombre de la impresora.
[in] pDevmode
Puntero proporcionado por el autor de la llamada a una estructura de DEVMODEW que se pasa al procesador de impresión o al controlador de impresora.
[in] dwLevel
Valor proporcionado por el autor de la llamada que indica el tipo de estructura al que apunta pAttributeInfo, como se indica en la tabla siguiente. Para obtener más información, consulte la sección comentarios de a continuación.
| valor de dwLevel | Estructura a la que apunta pAttributeInfo |
|---|---|
| 1 | ATTRIBUTE_INFO_1 |
| 2 | ATTRIBUTE_INFO_2 |
| 3 | ATTRIBUTE_INFO_3 |
| 4 | ATTRIBUTE_INFO_4 |
[out] pAttributeInfo
Puntero proporcionado por el autor de la llamada a una estructura de información de atributo (ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3o ATTRIBUTE_INFO_4) que recibe información sobre el trabajo de impresión.
[in] nSize
Tamaño del búfer, en bytes, al que apunta pAttributeInfo.
[in] dwFlags
Si establece el autor de la llamada en FILL_WITH_DEFAULTS, el administrador de cola rellenará pAttributeInfo con valores predeterminados del nivel 1 hasta el nivel especificado por dwLevel.
Por ejemplo, si dwLevel es 4 y se especifica FILL_WITH_DEFAULTS, pAttributeInfo se rellenarán con los siguientes valores de miembro predeterminados de ATTRIBUTE_INFO_4:
dwJobNumberOfPagesPerSide = 1
dwDrvNumberOfPagesPerSide = 1
dwNupBorderFlags = 0
dwJobPageOrderFlags = 0
dwDrvPageOrderFlags = 0
miembro dwJobNumberOfCopies = dmCopies miembro de DEVMODEW
miembro dwDrvNumberOfCopies = dmCopies de DEVMODEW
dwColorOptimization = 0
miembro dmPrintQuality = dmPrintQuality de DEVMODEW
miembro dmYResolution = dmYResolution de DEVMODEW
dwNupDirection = RIGHT_THEN_DOWN
dwBookletFlags = BOOKLET_EDGE_LEFT
dwDuplexFlags = 0
dwScalingPercentX = 100
dwScalingPercentY = 100
dwJobHandlingFlags = 0
Valor devuelto
GetJobAttributesEx devuelve TRUE si se consigue obtener correctamente los atributos del trabajo de impresión; de lo contrario, devuelve FALSE.
Observaciones
Esta función comprueba primero si el controlador admite el nivel de atributo indicado por dwLevel. Si el controlador no admite ese nivel de atributo, la función consulta el controlador para obtener compatibilidad con el siguiente nivel inferior, (dwLevel - 1) y continúa consultando los niveles de soporte técnico progresivamente inferiores hasta que obtenga el nivel de soporte proporcionado por el controlador. Si dwFlags se establece en FILL_WITH_DEFAULTS, la función rellena los valores predeterminados de los niveles no admitidos.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | Spoolss.lib |
| DLL de | Spoolss.dll |