Interface IPropertyNotifySink (ocidl.h)

  • Artigo

Implementado por um objeto de coletor para receber notificações sobre alterações de propriedade de um objeto que dá suporte a IPropertyNotifySink como uma interface de saída. O cliente que precisa receber as notificações nessa interface (de um objeto conectável de suporte) cria um coletor com essa interface e o conecta ao objeto conectável por meio do mecanismo de ponto de conexão. Para obter mais informações sobre pontos de conexão, consulte IConnectionPointContainer.

Herança

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

Métodos

A interface IPropertyNotifySink tem esses métodos.

 
IPropertyNotifySink::OnChanged

Notifica um coletor de que uma propriedade associável foi alterada.
IPropertyNotifySink::OnRequestEdit

Notifica um coletor de que uma propriedade requestedit está prestes a ser alterada.

Comentários

O objeto é necessário para chamar os métodos de IPropertyNotifySink somente para as propriedades marcadas com os atributos [associável] e [requestedit] nas informações de tipo do objeto. Quando o objeto altera uma propriedade [associável], é necessário chamar IPropertyNotifySink::OnChanged. Quando o objeto está prestes a alterar uma propriedade [requestedit], ele deve chamar IPropertyNotifySink::OnRequestEdit antes de alterar a propriedade e também deve respeitar a ação especificada pelo coletor no retorno dessa chamada.

A única exceção a essa regra é que nenhuma notificação é enviada como resultado dos procedimentos de inicialização ou carregamento de um objeto. No momento da inicialização, supõe-se que todas as propriedades sejam alteradas e que todas devem ter permissão para serem alteradas. As notificações para essa interface são, portanto, significativas apenas no contexto de um objeto totalmente inicializado/carregado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

IConnectionPoint

IConnectionPointContainer