Interface IPrintAsyncNotifyDataObject (prnasnot.h)

Encapsula os dados enviados em um canal de notificação.

Herança

A interface IPrintAsyncNotifyDataObject herda da interface IUnknown . IPrintAsyncNotifyDataObject também tem estes tipos de membros:

Métodos

A interface IPrintAsyncNotifyDataObject tem esses métodos.

IPrintAsyncNotifyDataObject::AcquireData Direciona os aplicativos ouvintes para os dados de notificação, incluindo o tamanho e o tipo dos dados.
IPrintAsyncNotifyDataObject::ReleaseData Libera a memória usada pelos dados encapsulados em IPrintAsyncNotifyDataObject.

Comentários

Os aplicativos ouvintes devem chamar ReleaseData quando terminarem de consumir os dados de notificação obtidos com AcquireData.

A interface IPrintAsyncNotifyDataObject deve ser implementada de uma maneira que garanta que uma chamada de IUnknown::Release não libere o objeto se um aplicativo de escuta não tiver terminado de consumir os dados do objeto. Assim, se uma chamada para Release ocorrer quando um aplicativo tiver chamado AcquireData , mas ainda não tiver chamado ReleaseData , o objeto não deverá ser liberado. Por esse motivo, recomendamos que AcquireData use IUnknown::AddRef para incrementar a contagem de referência do objeto e que ReleaseData decremente a contagem.

Os aplicativos de escuta podem estar ativos no processo do Spooler de Impressão, bem como fora dele. Quando o ouvinte está fora desse processo, ele pode acessar apenas os métodos IPrintAsyncNotifyDataObject . Portanto, se o IPrintAsyncNotifyDataObject também implementar uma interface própria, lembre-se de que os métodos da interface estão disponíveis apenas para escutar aplicativos dentro do processo do Spooler de Impressão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	prnasnot.h

Confira também

Interfaces de notificação de impressão assíncronas

Impressão