AppendPrinterNotifyInfoData 함수(winsplp.h)

아티클
08/08/2023

인쇄 스풀러의 AppendPrinterNotifyInfoData 함수는 지정된 PRINTER_NOTIFY_INFO_DATA 구조체의 내용을 지정된 PRINTER_NOTIFY_INFO 구조체에 추가합니다.

구문

BOOL AppendPrinterNotifyInfoData(
  [in] PPRINTER_NOTIFY_INFO      pInfoDest,
       PPRINTER_NOTIFY_INFO_DATA pDataSrc,
       DWORD                     fdwFlags
);

매개 변수

[in] pInfoDest

PRINTER_NOTIFY_INFO 구조체에 대한 호출자 제공 포인터입니다.

pDataSrc

PRINTER_NOTIFY_INFO_DATA 구조체에 대한 호출자 제공 포인터입니다.

fdwFlags

호출자가 제공한 플래그입니다. 다음 플래그가 정의됩니다.

PRINTER_NOTIFY_INFO_DATA_COMPACT
설정된 경우 함수는 제공된 PRINTER_NOTIFY_INFO_DATA 구조체의 Type, Field 및 Id 멤버를 검사합니다. 모두 PRINTER_NOTIFY_INFO_DATA 구조 배열의 기존 요소와 일치하는 경우 기존 요소는 제공된 요소로 덮어씁니다. 일치 항목을 찾을 수 없는 경우 함수는 배열의 끝에 지정된 구조를 추가합니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환합니다. 그렇지 않으면 함수는 FALSE를 반환 합니다. 호출자는 GetLastError를 호출하여 오류 코드를 가져올 수 있습니다.

설명

인쇄 공급자의 RefreshPrinterChangeNotification 함수는 먼저 RouterAllocPrinterNotifyInfo를 호출하여 배열 및 관련 PRINTER_NOTIFY_INFO 구조체에 대한 스토리지를 할당한 후 PRINTER_NOTIFY_INFO_DATA 구조 배열을 채우기 위해 필요한 만큼 AppendPrinterNotifyInfoData를 호출해야 합니다.

PRINTER_NOTIFY_INFO_DATA_COMPACT 플래그가 설정되었는지 여부에 따라 함수는 지정된 PRINTER_NOTIFY_INFO_DATA 구조를 구조체 배열의 끝에 추가하거나 기존 배열 요소를 덮어씁니다. 구조체가 추가되면 함수는 PRINTER_NOTIFY_INFO 구조체의 Count 멤버를 증가합니다.

AppendPrinterNotifyInfoData가 지정된 PRINTER_NOTIFY_INFO 구조체에서 PRINTER_NOTIFY_INFO_DISCARDED 플래그가 설정되어 있음을 감지하면 함수는 모든 PRINTER_NOTIFY_INFO_DATA 구조를 지우고 오류 코드를 ERROR_OUT_OF_STRUCTURES 설정합니다.

pInfoDataSrc에 대해 NULL을 지정한 경우 AppendPrinterNotifyInfoData는 지정된 PRINTER_NOTIFY_INFO 구조체에서 PRINTER_NOTIFY_INFO_DISCARDED 플래그를 설정하고, 모든 PRINTER_NOTIFY_INFO_DATA 구조를 지우고, 오류 코드를 ERROR_OUT_OF_STRUCTURES 설정합니다.

(PRINTER_NOTIFY_INFO_DISCARDED 플래그에 대한 자세한 내용은 Windows SDK 설명서에서 FindNextPrinterChangeNotification에 대한 설명을 참조하세요.

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