Metodo IConnectionPoint::Advise (ocidl.h)
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 |
---|---|
|
La connessione è stata stabilita e *pdwCookie ha il token di connessione. |
|
Il valore in pUnkSink o pdwCookie non è valido. Ad esempio, un puntatore può essere NULL. |
|
Il punto di connessione ha già raggiunto il limite di connessioni e non è in grado di accettarne altre. |
|
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 |