Метод ITfSource::AdviseSink (msctf.h)

Статья
08/24/2023

Устанавливает приемник рекомендаций.

Синтаксис

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

Параметры

[in] riid

Определяет тип приемника рекомендаций для установки.

Этот параметр может быть одним из следующих значений при получении объекта ITfSource из объекта ITfThreadMgr .

Этот параметр может быть одним из следующих значений при получении объекта ITfSource из объекта ITfContext .

Значение	Значение
IID_ITfActiveLanguageProfileNotifySink	Устанавливает приемник рекомендаций ITfActiveLanguageProfileNotifySink .
IID_ITfDisplayAttributeNotifySink	Устанавливает приемник рекомендаций ITfDisplayAttributeNotifySink .
IID_ITfKeyTraceEventSink	Устанавливает приемник рекомендаций ITfKeyTraceEventSink .
IID_ITfPreservedKeyNotifySink	Устанавливает приемник рекомендаций ITfPreservedKeyNotifySink .
IID_ITfThreadFocusSink	Устанавливает приемник рекомендаций ITfThreadFocusSink .
IID_ITfThreadMgrEventSink	Устанавливает приемник рекомендаций ITfThreadMgrEventSink .

[in] punk

Совет приемник IUnknown указатель.

[out] pdwCookie

Адрес значения DWORD, получающего идентифицирующие файлы cookie. Это значение используется для удаления приемника рекомендаций при последующем вызове ITfSource::UnadviseSink. Получает (DWORD)-1 в случае сбоя.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Один или несколько параметров недопустимы.
CONNECT_E_CANNOTCONNECT	Невозможно установить приемник рекомендаций.
CONNECT_E_ADVISELIMIT	Достигнуто максимальное число приемников рекомендаций.
E_FAIL	Произошла неизвестная ошибка.
E_OUTOFMEMORY	Произошел сбой выделения памяти.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	msctf.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Professional