Metodo ITfSource::AdviseSink (msctf.h)

Articolo
08/24/2023

Installa un sink di avviso.

Sintassi

HRESULT AdviseSink(
  [in]  REFIID   riid,
  [in]  IUnknown *punk,
  [out] DWORD    *pdwCookie
);

Parametri

[in] riid

Identifica il tipo di sink consigliato da installare.

Questo parametro può essere uno dei valori seguenti quando l'oggetto ITfSource viene ottenuto da un oggetto ITfThreadMgr .

Questo parametro può essere uno dei valori seguenti quando l'oggetto ITfSource viene ottenuto da un oggetto ITfContext .

Valore	Significato
IID_ITfActiveLanguageProfileNotifySink	Installa un sink ITfActiveLanguageProfileNotifySink .
IID_ITfDisplayAttributeNotifySink	Installa un sink di avviso ITfDisplayAttributeNotifySink .
IID_ITfKeyTraceEventSink	Installa un sink di avviso ITfKeyTraceEventSink .
IID_ITfPreservedKeyNotifySink	Installa un sink consigliato ITfPreservedKeyNotifySink .
IID_ITfThreadFocusSink	Installa un sink ITfThreadFocusSink consigliato.
IID_ITfThreadMgrEventSink	Installa un sink di avviso ITfThreadMgrEventSink .

[in] punk

Puntatore IUnknown consigliato.

[out] pdwCookie

Indirizzo di un valore DWORD che riceve un cookie di identificazione. Questo valore viene usato per disinstallare il sink di avviso in una chiamata successiva a ITfSource::UnadviseSink. Riceve (DWORD)-1 se si verifica un errore.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Uno o più parametri non sono validi.
CONNECT_E_CANNOTCONNECT	Il sink di avviso non può essere installato.
CONNECT_E_ADVISELIMIT	È stato raggiunto il numero massimo di sink di avviso.
E_FAIL	Si è verificato un errore non specificato.
E_OUTOFMEMORY	Si è verificato un errore di allocazione della memoria.

Requisiti


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	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional