GetJobAttributesEx 함수(winsplp.h)

아티클
03/01/2024

경고

Windows 10 타사 인쇄 공급자를 지원하는 API는 더 이상 사용되지 않습니다. Microsoft는 타사 인쇄 공급자에 대한 투자를 권장하지 않습니다. 또한 v4 인쇄 드라이버 모델을 사용할 수 있는 Windows 8 최신 제품에서는 타사 인쇄 공급자가 v4 인쇄 드라이버를 사용하는 큐를 만들거나 관리할 수 없습니다.

인쇄 공급자의 GetJobAttributesEx 함수는 N-up 및 역방향 인쇄 옵션을 포함하여 인쇄 작업에 대한 정보를 가져옵니다.

구문

BOOL GetJobAttributesEx(
  [in]  LPWSTR     pPrinterName,
  [in]  LPDEVMODEW pDevmode,
  [in]  DWORD      dwLevel,
  [out] LPBYTE     pAttributeInfo,
  [in]  DWORD      nSize,
  [in]  DWORD      dwFlags
);

매개 변수

[in] pPrinterName

프린터 이름을 포함하는 NULL로 끝나는 유니코드 문자열에 대한 호출자 제공 포인터입니다.

[in] pDevmode

인쇄 프로세서 또는 프린터 드라이버에 전달되는 DEVMODEW 구조체에 대한 호출자 제공 포인터입니다.

[in] dwLevel

다음 표에 표시된 대로 pAttributeInfo가 가리키는 구조체의 형식을 나타내는 호출자 제공 값입니다. 자세한 내용은 아래 설명 섹션을 참조하세요.

dwLevel 값	pAttributeInfo가 가리키는 구조체
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] pAttributeInfo

인쇄 작업에 대한 정보를 수신하는 특성 정보 구조(ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3 또는 ATTRIBUTE_INFO_4)에 대한 호출자 제공 포인터입니다.

[in] nSize

pAttributeInfo가 가리키는 버퍼의 크기(바이트)입니다.

[in] dwFlags

호출자가 FILL_WITH_DEFAULTS 설정하면 스풀러는 pAttributeInfo 를 수준 1부터 dwLevel로 지정된 수준까지의 기본값으로 채웁니다.

예를 들어 dwLevel 이 4이고 FILL_WITH_DEFAULTS 지정된 경우 pAttributeInfo 는 다음과 같은 ATTRIBUTE_INFO_4 기본 멤버 값으로 채워집니다.

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = DEVMODEW의 dmCopies 멤버

dwDrvNumberOfCopies = DEVMODEW의 dmCopies 멤버

dwColorOptimization = 0

dmPrintQuality = DEVMODEW의 dmPrintQuality 멤버

dmYResolution = DEVMODEW의 dmYResolution 멤버

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercenty = 100

dwJobHandlingFlags = 0

반환 값

GetJobAttributesEx 는 인쇄 작업 특성을 성공적으로 가져오는 데 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다.

설명

이 함수는 먼저 드라이버가 dwLevel로 표시된 특성 수준을 지원하는지 여부를 확인합니다. 드라이버가 해당 특성 수준을 지원하지 않는 경우 함수는 드라이버에 다음 하위 수준(dwLevel - 1)에 대한 지원을 쿼리하고 드라이버에서 제공하는 지원 수준을 얻을 때까지 점진적으로 낮은 수준의 지원을 계속 쿼리합니다. dwFlags가 FILL_WITH_DEFAULTS 설정된 경우 함수는 지원되지 않는 수준에 대한 기본값을 채웁니다.