Método IPrintAsyncNotifyDataObject::AcquireData (prnasnot.h)
Dirige las aplicaciones de escucha a los datos de notificación, incluido el tamaño y el tipo de los datos.
Sintaxis
HRESULT AcquireData(
[out] BYTE **ppNotificationData,
[out] ULONG *pSize,
[out] PrintAsyncNotificationType **ppSchema
);
Parámetros
[out] ppNotificationData
Búfer que contiene los datos de notificación.
[out] pSize
Tamaño del búfer de datos.
[out] ppSchema
Puntero GUID al esquema de datos.
Valor devuelto
Consulte PrintAsyncNotifyError para conocer los valores posibles.
Para obtener más información sobre los códigos de error COM, vea Control de errores.
Comentarios
Las aplicaciones que llaman a este método deben llamar a ReleaseData cuando hayan terminado de consumir los datos de notificación.
La interfaz IPrintAsyncNotifyDataObject debe implementarse para asegurarse de que una llamada de IUnknown::Release no libera el objeto si una aplicación de escucha no ha terminado de consumir los datos del objeto. En consecuencia, si se produce una llamada a Release cuando una aplicación ha llamado a AcquireData pero aún no ha llamado a ReleaseData , el objeto no debe liberarse. Por este motivo, se recomienda que AcquireData use IUnknown::AddRef para incrementar el recuento de referencias del objeto y que ReleaseData disminuya el recuento.
Cuando se produce un error en el administrador de trabajos de impresión, crea un objeto IPrintAsyncNotifyDataObject . Cuando un agente de escucha llama a AcquireData para esta notificación, ppNotificationData es NULL, el tamaño es 0 y ppSchema se NOTIFICATION_RELEASE.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | prnasnot.h |
| Archivo DLL | Prnasnot.dll |