Compartilhar via


Método ITfLangBarItemMgr::AdviseItemSink (ctfutb.h)

Instala um coletor de eventos de item de barra de idiomas para um item de barra de idiomas.

Sintaxe

HRESULT AdviseItemSink(
  [in]  ITfLangBarItemSink *punk,
  [out] DWORD              *pdwCookie,
  [in]  REFGUID            rguidItem
);

Parâmetros

[in] punk

Ponteiro para o objeto ITfLangBarItemSink a ser instalado.

[out] pdwCookie

Ponteiro para um DWORD que recebe um cookie de identificação do coletor de aconselhamento. Esse cookie identifica o coletor de aconselhamento quando ele é removido com o método ITfLangBarItemMgr::UnadviseItemSink ou ITfLangBarItemMgr::UnadviseItemsSink .

[in] rguidItem

Contém o GUID que identifica o item para o qual instalar o coletor de consultoria. Esse é o GUID do item que o item fornece em ITfLangBarItem::GetInfo. Isso pode ser um valor personalizado ou um dos itens de barra de idiomas predefinidos.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
E_FAIL
Ocorreu um erro não especificado.
E_INVALIDARG
rguidItem é inválido.
E_OUTOFMEMORY
Ocorreu uma falha de alocação de memória.
E_POINTER
punk e/ou pdwCookie é inválido.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ctfutb.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

ITfLangBarItem::GetInfo

ITfLangBarItemMgr

ITfLangBarItemMgr::UnadviseItemSink

ITfLangBarItemMgr::UnadviseItemsSink

ITfLangBarItemSink

Itens de barra de idiomas predefinidos