RouterAllocPrinterNotifyInfo 함수(winsplp.h)

아티클
02/27/2024

인쇄 스풀러의 RouterAllocPrinterNotifyInfo 함수는 PRINTER_NOTIFY_INFO 구조체와 PRINTER_NOTIFY_INFO_DATA 구조체 배열을 할당합니다. (이러한 구조체는 Microsoft Windows SDK 설명서에 설명되어 있습니다.)

구문

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

매개 변수

cPrinterNotifyInfoData

할당할 PRINTER_NOTIFY_INFO_DATA 구조체 배열의 크기를 지정하는 호출자 제공 번호입니다.

반환 값

함수는 할당된 PRINTER_NOTIFY_INFO 구조체에 대한 포인터를 반환합니다.

설명

인쇄 공급자는 를 호출 RouterAllocPrinterNotifyInfo 하여 공급자의 RefreshPrinterChangeNotification 함수가 제공해야 하는 PRINTER_NOTIFY_INFO 구조체 및 PRINTER_NOTIFY_INFO_DATA 구조 배열을 할당해야 합니다.

함수는 RouterAllocPrinterNotifyInfo PRINTER_NOTIFY_INFO 구조체의 Version 멤버를 스풀러 알림 구현의 현재 버전으로 초기화합니다. cPrinterNotifyInfoData에 지정된 수에 관계없이 구조체의 Flags 및 Count 멤버를 0으로 초기화합니다.

인쇄 공급자는 AppendPrinterNotifyInfoData 를 호출하여 PRINTER_NOTIFY_INFO_DATA 구조 배열의 멤버를 채워야 합니다.

가 성공적으로 실행되고 할당된 구조를 호출자에게 반환하는 경우 RefreshPrinterChangeNotification 호출자가 구조체 메모리의 할당을 취소한다고 가정해야 합니다. 그러나 RefreshPrinterChangeNotification 오류가 발생하면 RouterFreePrinterNotifyInfo 를 호출하여 메모리의 할당을 취소해야 합니다.

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