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 |