Compartir a través de


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

Consulte también

Interfaces de notificación de impresión asincrónica

IPrintAsyncNotifyDataObject

Impresión