ITfLangBarItemMgr::AdviseItemsSink method (ctfutb.h)

Installs one or more language bar item event sinks for one or more language bar items.

Syntax

HRESULT AdviseItemsSink(
  [in]  ULONG              ulCount,
  [in]  ITfLangBarItemSink **ppunk,
  [in]  const GUID         *pguidItem,
  [out] DWORD              *pdwCookie
);

Parameters

[in] ulCount

Contains the number of advise sinks to install.

[in] ppunk

Pointer to an array of ITfLangBarItemSink objects to install. This array must be at least ulCount elements in length.

[in] pguidItem

Pointer to an array of GUIDs that identify the items to install the advise sinks for. These are the item GUIDs that the item supplies in ITfLangBarItem::GetInfo. This array must be at least ulCount elements in length.

[out] pdwCookie

Pointer to an array of DWORDs that receive the corresponding advise sink identification cookies. These cookies identify the advise sinks when they are removed with the ITfLangBarItemMgr::UnadviseItemSink or ITfLangBarItemMgr::UnadviseItemsSink method. This array must be at least ulCount elements in length.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
E_FAIL
An unspecified error occurred.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ctfutb.h
DLL Msctf.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

ITfLangBarItem::GetInfo

ITfLangBarItemMgr

ITfLangBarItemMgr::UnadviseItemSink

ITfLangBarItemMgr::UnadviseItemsSink

ITfLangBarItemSink