ITfSource::AdviseSink-Methode (msctf.h)

Artikel
08/24/2023

Installiert eine Empfehlungssenke.

Syntax

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

Parameter

[in] riid

Gibt den Typ der zu installierenden Empfehlungssenke an.

Dieser Parameter kann einer der folgenden Werte sein, wenn das ITfSource-Objekt aus einem ITfThreadMgr-Objekt abgerufen wird.

Dieser Parameter kann einer der folgenden Werte sein, wenn das ITfSource-Objekt aus einem ITfContext-Objekt abgerufen wird.

Wert	Bedeutung
IID_ITfActiveLanguageProfileNotifySink	Installiert eine ITfActiveLanguageProfileNotifySink-Empfehlungssenke .
IID_ITfDisplayAttributeNotifySink	Installiert eine ITfDisplayAttributeNotifySink-Empfehlungssenke .
IID_ITfKeyTraceEventSink	Installiert eine ITfKeyTraceEventSink-Empfehlungssenke .
IID_ITfPreservedKeyNotifySink	Installiert eine ITfPreservedKeyNotifySink-Empfehlungssenke .
IID_ITfThreadFocusSink	Installiert eine ITfThreadFocusSink-Empfehlungssenke .
IID_ITfThreadMgrEventSink	Installiert eine ITfThreadMgrEventSink-Empfehlungssenke .

[in] punk

Der IUnknown-Zeiger für die Empfehlungssenke.

[out] pdwCookie

Adresse eines DWORD-Werts, der ein identifizierende Cookie empfängt. Dieser Wert wird verwendet, um die Empfehlungssenke in einem nachfolgenden Aufruf von ITfSource::UnadviseSink zu deinstallieren. Empfängt (DWORD)-1, wenn ein Fehler auftritt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
CONNECT_E_CANNOTCONNECT	Die Empfehlungssenke kann nicht installiert werden.
CONNECT_E_ADVISELIMIT	Die maximale Anzahl von Beratungssenken wurde erreicht.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_OUTOFMEMORY	Ein Speicherbelegungsfehler ist aufgetreten.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional