Partilhar via


AfxConnectionAdvise

Chamar esta função para estabelecer uma conexão entre uma origem especificada por pUnkSrce um coletor especificada 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 identificação da interface da conexão.

  • bRefCount
    TRUE indica que a criação da conexão deve causar a contagem de referência de pUnkSink devem ser incrementadas.FALSE indica que a contagem de referência não deve ser incrementada.

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

Valor de retorno

Diferente de zero se a conexão foi estabelecida; Caso contrário, 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

Cabeçalho: afxctl.h

Consulte também

Referência

AfxConnectionUnadvise

Conceitos

Globais e Macros do MFC