Metodo IConnectionPoint::Advise (ocidl.h)

  • Articolo

Stabilisce una connessione tra un oggetto punto di connessione e il sink del client.

Sintassi

HRESULT Advise(
  [in]  IUnknown *pUnkSink,
  [out] DWORD    *pdwCookie
);

Parametri

[in] pUnkSink

Puntatore all'interfaccia IUnknown nel sink di consigli del client. Il sink del client riceve chiamate in uscita dal punto di connessione.

[out] pdwCookie

Puntatore a un token restituito che identifica in modo univoco questa connessione. Il chiamante usa questo token in un secondo momento per eliminare la connessione passandola al metodo IConnectionPoint::Unadvise . Se la connessione non è stata stabilita correttamente, questo valore è zero.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito Descrizione
S_OK
 La connessione è stata stabilita e *pdwCookie ha il token di connessione.
E_POINTER
 Il valore in pUnkSink o pdwCookie non è valido. Ad esempio, un puntatore può essere NULL.
CONNECT_E_ADVISELIMIT
 Il punto di connessione ha già raggiunto il limite di connessioni e non è in grado di accettarne altre.
CONNECT_E_CANNOTCONNECT
 Il sink non supporta l'interfaccia richiesta da questo punto di connessione.

Commenti

Avvisare stabilisce una connessione tra il punto di connessione e il sink del chiamante identificato con pUnkSink.

Il punto di connessione deve chiamare QueryInterface per ottenere il puntatore dell'interfaccia in uscita corretto da chiamare quando si verificano eventi, con l'IID per l'interfaccia in uscita gestita dal punto di connessione. Quando l'IID viene passato al metodo IConnectionPointContainer::FindConnectionPoint , viene restituito un puntatore dell'interfaccia a questo stesso punto di connessione.

Note per gli implementatori

Il punto di connessione deve eseguire una query sul puntatore pUnkSink per l'interfaccia in uscita corretta. Se questa query ha esito negativo, questo metodo deve restituire CONNECT_E_CANNOTCONNECT.

Il valore pdwCookie deve essere univoco per ogni connessione a qualsiasi istanza di un punto di connessione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione ocidl.h

Vedi anche

IConnectionPoint