Metodo ITextStoreAnchor::AdviseSink (textstor.h)
Il metodo ITextStoreAnchor::AdviseSink installa un nuovo sink di avviso dall'interfaccia ITextStoreAnchorSink o modifica un sink consigliato esistente.
Sintassi
HRESULT AdviseSink(
[in] REFIID riid,
[in] IUnknown *punk,
[in] DWORD dwMask
);
Parametri
[in] riid
Specifica l'interfaccia sink. L'unico valore supportato è IID_ITextStoreAnchorSink.
[in] punk
Puntatore all'interfaccia sink da consigliare. Non può essere NULL.
[in] dwMask
Specifica gli eventi che notificano al sink di avviso. Per altre informazioni sui possibili valori dei parametri, vedere costanti TS_AS_*.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Descrizione |
|---|---|
|
Il metodo è stato eseguito correttamente. |
|
Impossibile ottenere il riid dell'interfaccia sink specificato. |
|
L'interfaccia sink specificata non è supportata. |
|
Impossibile ottenere l'oggetto sink specificato. |
Commenti
Le chiamate successive con la stessa interfaccia, rappresentata dal parametro punk , vengono gestite come richieste di aggiornamento del parametro dwMask . I server non devono chiamare il metodo AddRef nel sink in risposta a tale richiesta.
I server mantengono solo un singolo punto di connessione. I tentativi di consigliare un secondo oggetto sink hanno esito negativo fino a quando non viene rimosso l'oggetto sink originale. Le applicazioni devono usare il metodo ITextStoreAnchor::UnadviseSink per annullare la registrazione dell'oggetto sink quando le notifiche non sono necessarie.
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 | textstor.h |
| DLL | Msctf.dll |
| Componente ridistribuibile | TSF 1.0 in Windows 2000 Professional |