Partilhar via

Classe IRowsetNotifyCP

  • Artigo

Implementa o site do provedor para a interface do ponto de conexão IRowsetNotify.

Sintaxe

template <class T, class ReentrantEventSync = CComSharedMutex>
class IRowsetNotifyCP :
   public IConnectionPointImpl<
      T,
      piid = &__uuidof(IRowsetNotify),
      CComDynamicUnkArray DynamicUnkArray>,
   public ReentrantEventSync

Parâmetros

T
Uma classe derivada de IRowsetNotifyCP.

ReentrantEventSync
Uma classe de mutex que dá suporte à reentrância (o padrão é CComSharedMutex). Um mutex é um objeto de sincronização que permite a um thread o acesso mutuamente exclusivo a um recurso.

piid
Um ponteiro de ID de interface (IID*) para uma interface de ponto de conexão IRowsetNotify. O valor padrão é &__uuidof(IRowsetNotify).

DynamicUnkArray
Uma matriz do tipo CComDynamicUnkArray, que é uma matriz de ponteiros IUnknown alocada dinamicamente para as interfaces do coletor do cliente.

Requisitos

Cabeçalho: atldb.h

Membros

Métodos

Nome Descrição
Fire_OnFieldChange Notifica o consumidor sobre uma alteração no valor de uma coluna.
Fire_OnRowChange Notifica o consumidor sobre uma alteração que afete as linhas.
Fire_OnRowsetChange Notifica o consumidor sobre uma alteração que afete todo o conjunto de linhas.

Comentários

IRowsetNotifyCP implementa funções de difusão para aconselhar os ouvintes no ponto de conexão de alterações IID_IRowsetNotify sobre o conteúdo do conjunto de linhas.

Observe que você também deve implementar e registrar IRowsetNotify no consumidor (também conhecido como "coletor") usando IRowsetNotifyImpl para que o consumidor possa lidar com as notificações. Confira Notificações de Recebimento sobre a implementação da interface do ponto de conexão no consumidor.

Para obter informações detalhadas sobre como implementar notificações, consulte "Notificações de suporte" em Criar um provedor atualizável.

IRowsetNotifyCP::Fire_OnFieldChange

Transmite um evento OnFieldChange para notificar os consumidores sobre uma alteração no valor de uma coluna.

Sintaxe

HRESULT Fire_OnFieldChange(IRowset* pRowset,
   HROW hRow,
   DBORDINAL cColumns,
   DBORDINAL* rgColumns,
   DBREASON eReason,
   DBEVENTPHASE ePhase,
   BOOL fCantDeny);

Parâmetros

Consulte IRowsetNotify::OnFieldChange na Referência do programador OLE DB.

IRowsetNotifyCP::Fire_OnRowChange

Transmite um evento OnRowChange para todos os ouvintes no ponto de conexão IID_IRowsetNotify para notificar os consumidores sobre uma alteração que afeta as linhas.

Sintaxe

HRESULT Fire_OnRowChange(IRowset* pRowset,
   DBCOUNTITEM cRows,
   const HROW rghRows[],
   DBREASON eReason,
   DBEVENTPHASE ePhase,
   BOOL fCantDeny);

Parâmetros

Consulte IRowsetNotify::OnRowChange na Referência do programador OLE DB.

IRowsetNotifyCP::Fire_OnRowsetChange

Transmite um evento OnRowsetChange para todos os ouvintes no ponto de conexão IID_IRowsetNotify para notificar os consumidores sobre uma alteração que afeta todo o conjunto de linhas.

Sintaxe

HRESULT Fire_OnRowsetChange(IRowset* pRowset,
   DBREASON eReason,
   DBEVENTPHASE ePhase,
   BOOL fCantDeny);

Parâmetros

Consulte IRowsetNotify::OnRowsetChange na Referência do programador OLE DB.

Confira também

Modelos de Provedor OLE DB
Arquitetura de modelo do provedor do OLE DB
Notificações (COM)
BEGIN_CONNECTION_POINT_MAP
END_CONNECTION_POINT_MAP
CONNECTION_POINT_ENTRY
Criando um provedor atualizável