Función GetJobAttributesEx (winsplp.h)

Artículo
08/08/2023

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 ni administren colas que usen 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 inversa y N.

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 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, vea la sección Comentarios a continuación.

valor 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_3 o 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 el autor de la llamada establece en FILL_WITH_DEFAULTS, el administrador de colas 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á con los siguientes valores de miembro predeterminados de ATTRIBUTE_INFO_4:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = dmCopies miembro de DEVMODEW

dwDrvNumberOfCopies = dmCopies miembro de DEVMODEW

dwColorOptimization = 0

dmPrintQuality = dmPrintQuality miembro de DEVMODEW

dmYResolution = dmYResolution miembro 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 obtiene correctamente los atributos del trabajo de impresión; de lo contrario, devuelve FALSE.

Comentarios

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 al 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 compatibilidad proporcionado por el controlador. Si dwFlags se establece en FILL_WITH_DEFAULTS, la función rellena los valores predeterminados para los niveles no admitidos.