Compartilhar via


AfxConnectionAdvise

Chamar essa função para estabelecer uma conexão entre uma fonte, especificada por pUnkSrc, e um coletor, especificado por pUnkSink.

BOOL AFXAPI AfxConnectionAdvise( 
   LPUNKNOWN pUnkSrc, 
   REFIID iid, 
   LPUNKNOWN pUnkSink, 
   BOOL bRefCount, 
   DWORD FAR* pdwCookie  
);

Parâmetros

  • pUnkSrc
    Um ponteiro para o objeto que chama a interface.

  • pUnkSink
    Um ponteiro para o objeto que implementa a interface.

  • iid
    A ID da interface de conexão.

  • bRefCount
    Verdadeiro indica que o criar a conexão deve causar a contagem de referência de pUnkSink a ser incrementado. Falso indica que a contagem de referência não deve ser incrementado.

  • pdwCookie
    Um ponteiro para DWORD onde um identificador de conexão é retornado. Esse valor deve ser passado como o parâmetro de dwCookie a AfxConnectionUnadvise ao desabilitar a conexão.

Valor de retorno

Diferente de zero se uma conexão foi estabelecida; se não 0.

Exemplo

//CMySink is a CCmdTarget-derived class supporting automation. 
//Instantiate the sink class.
CMySink mysink;

//Get a pointer to sink's IUnknown, no AddRef done.
IID iid = IID_IUnknown;
IUnknown* pUnkSink = mysink.GetInterface(&iid);

//Establish a connection between source and sink. 
//pUnkSrc is IUnknown of server obtained by CoCreateInstance(). 
//dwCookie is a cookie identifying the connection, and is needed 
//to terminate this connection.
AfxConnectionAdvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, &dwCookie);

Requisitos

Header: afxctl.h

Consulte também

Referência

AfxConnectionUnadvise

Conceitos

Macros e globais MFC