IPrintAsyncNotifyDataObject::AcquireData 메서드(prnasnot.h)
수신 대기 애플리케이션을 데이터의 크기 및 형식을 포함한 알림 데이터로 전달합니다.
구문
HRESULT AcquireData(
[out] BYTE **ppNotificationData,
[out] ULONG *pSize,
[out] PrintAsyncNotificationType **ppSchema
);
매개 변수
[out] ppNotificationData
알림 데이터를 포함하는 버퍼입니다.
[out] pSize
데이터 버퍼의 크기입니다.
[out] ppSchema
데이터 스키마에 대한 GUID 포인터입니다.
반환 값
가능한 값 은 PrintAsyncNotifyError 를 참조하세요.
COM 오류 코드에 관한 자세한 내용은 오류 처리를 참조하세요.
설명
이 메서드를 호출하는 애플리케이션은 알림 데이터 사용이 완료되면 ReleaseData 를 호출해야 합니다.
IPrintAsyncNotifyDataObject 인터페이스를 구현하여 수신 대기 애플리케이션이 개체의 데이터 소비를 완료하지 않은 경우 IUnknown::Release 호출이 개체를 해제하지 않도록 해야 합니다. 따라서 애플리케이션이 AcquireData를 호출했지만 아직 ReleaseData 를 호출하지 않은 경우 Release 호출이 발생하면 개체를 해제하지 않아야 합니다. 이러한 이유로 AcquireData 는 IUnknown::AddRef 를 사용하여 개체의 참조 수를 증가시키고 ReleaseData 는 개수를 감소시키는 것이 좋습니다.
Print Spooler가 실패하면 IPrintAsyncNotifyDataObject 개체를 만듭니다. 수신기가 이 알림에 대해 AcquireData 를 호출하면 ppNotificationData 는 NULL이고 크기는 0이고 ppSchema 는 NOTIFICATION_RELEASE.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | prnasnot.h |
| DLL | Prnasnot.dll |