FindFirstPrinterChangeNotification 함수(winspool.h)

아티클
03/01/2024

경고

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

인쇄 공급자의 FindFirstPrinterChangeNotification 함수는 지정된 인쇄 큐에서 지정된 이벤트 집합이 발생할 때 애플리케이션이 알림을 요청했음을 공급자에게 알릴 수 있습니다.

구문

HANDLE FindFirstPrinterChangeNotification(
  HANDLE hPrinter,
  DWORD  fdwFilter,
  DWORD  fdwOptions,
  PVOID  pPrinterNotifyOptions
);

매개 변수

hPrinter

이벤트 알림이 요청되는 프린터를 식별하는 호출자 제공 프린터 핸들입니다. 이 핸들은 이전에 OpenPrinter에서 가져와야 합니다.

fdwFilter

DWORD 매개 변수 fdwFilter를 정의합니다.

fdwOptions

사용되지 않습니다.

pPrinterNotifyOptions

PRINTER_NOTIFY_OPTIONS 구조체에 대한 호출자 제공 포인터입니다(Windows SDK 설명서에 설명되어 있습니다).

반환 값

인쇄 드라이버 핸들을 반환합니다.

설명

스풀러가 인쇄 공급자의 FindFirstPrinterChangeNotification 함수를 호출하면 pPrinterNotifyOptions 는 지정된 이벤트 중 하나가 발생할 때 인쇄 공급자가 스풀러에 보내야 하는 정보 유형을 식별합니다.

애플리케이션에서 요청할 수 있는 알림 유형 목록과 이벤트를 설명하는 데 사용할 수 있는 정보 유형 목록은 Windows SDK 설명서의 FindFirstPrinterChangeNotification 설명을 참조하세요. 애플리케이션이 알림을 요청할 수 있는 이벤트 유형에는 인쇄 작업 또는 양식 추가 또는 삭제가 포함됩니다. 애플리케이션에서 요청할 수 있는 정보 유형에는 작업 또는 양식 매개 변수가 포함됩니다.

인쇄 공급자가 폴링을 요청하지 않는 경우 인쇄 공급자는 PartialReplyPrinterChangeNotification 또는 ReplyPrinterChangeNotification을 호출하여 pPrinterNotifyOptions로 식별되는 정보 유형을 제공해야 합니다.

공급자가 폴링을 요청하는 경우(즉, PRINTER_NOTIFY_STATUS_POLL 설정) ReplyPrinterChangeNotification을 호출하면 안 됩니다. 대신 스풀러는 정기적으로 애플리케이션에 신호를 보냅니다.

폴링된 인쇄 공급자와 폴링되지 않은 인쇄 공급자는 RefreshPrinterChangeNotification 함수가 호출될 때마다 요청된 모든 정보 형식의 현재 상태를 반환해야 합니다.

자세한 내용은 프린터 변경 알림 지원을 참조하세요.