EnumJobs 함수

EnumJobs 함수는 지정된 프린터의 지정된 인쇄 작업 집합에 대한 정보를 검색합니다.

구문

BOOL EnumJobs(
  _In_  HANDLE  hPrinter,
  _In_  DWORD   FirstJob,
  _In_  DWORD   NoJobs,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pJob,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded,
  _Out_ LPDWORD pcReturned
);

매개 변수

hPrinter [ in]

함수가 열거하는 인쇄 작업의 프린터 개체에 대한 핸들입니다. OpenPrinter 또는 AddPrinter 함수를 사용하여 프린터 핸들을 검색합니다.

FirstJob [ in]

열거할 첫 번째 인쇄 작업의 인쇄 대기열 내의 위치(0 기반)입니다. 예를 들어 값이 0이면 인쇄 큐의 첫 번째 인쇄 작업에서 열거형이 시작됩니다. 값이 9이면 열거형이 인쇄 대기열의 10번째 인쇄 작업에서 시작됩니다.

NoJobs [ in]

열거할 인쇄 작업의 총 수입니다.

수준 [ in]

pJob 버퍼에 반환된 정보의 형식입니다.

의미
1
pJob은 JOB INFO _ _ 1 구조의 배열을 받습니다.
2
pJob은 JOB INFO _ _ 2 구조의 배열을 받습니다.
3
pJob은 JOB INFO _ _ 3 구조의 배열을 받습니다.

pJob [ out]

JOB _ INFO _ 1, JOB INFO 2또는 JOB INFO _ _ 3구조체의 배열을 받는 버퍼에 _ 대한 _ 포인터입니다. 버퍼는 구조체 배열과 구조체 멤버가 가리키는 문자열 또는 기타 데이터를 받을 수 있을 만큼 커야 합니다.

필요한 버퍼 크기를 확인하려면 cbBuf가 0으로 설정된 EnumJobs를 호출합니다. EnumJobs가 실패하고 GetLastError가 ERROR _ INSUFFICIENT _ BUFFER를 반환하며 pcbNeeded 매개 변수는 구조체 배열과 해당 데이터를 보유하는 데 필요한 버퍼의 크기(바이트)를 반환합니다.

cbBuf [ in]

pJob 버퍼의 크기(바이트)입니다.

pcbNeeded [ out]

함수가 성공하면 복사된 바이트 수를 받는 변수에 대한 포인터입니다. 함수가 실패하면 변수는 필요한 바이트 수를 받습니다.

pcReturned [ out]

pJob 버퍼에 반환된 JOB _ INFO _ 1,JOB INFO 2 또는 JOB INFO _ _ _ _ 3 구조체의 수를 받는 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다.

설명

참고

이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 반환되는 횟수는 애플리케이션을 작성할 때 예측하기 어려운 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현 요소와 같은 런타임 요인에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

JOB _ INFO _ 1 구조에는 일반적인 인쇄 작업 정보가 포함됩니다. JOB INFO _ _ 2 구조에는 훨씬 더 자세한 정보가 있습니다. JOB _ INFO _ 3 구조에는 작업이 연결되는 방법에 대한 정보가 포함되어 있습니다.

프린터 큐의 인쇄 작업 수를 확인하려면 Level 매개 변수가 2로 설정된 GetPrinter 함수를 호출합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 2000 Professional [데스크톱 앱만]
지원되는 최소 서버
Windows 2000 Server [데스크톱 앱만]
헤더
Winspool.h(Windows.h 포함)
라이브러리
Winspool.lib
DLL
Winspool.drv
유니코드 및 ANSI 이름
EnumJobsW(유니코드)EnumJobsA(ANSI)

참고 항목

인쇄

인쇄 스풀러 API 함수

GetJob

GetPrinter

작업 _ 정보 _ 1

작업 _ 정보 _ 2

작업 _ 정보 _ 3

OpenPrinter

SetJob