Método ITfSource::AdviseSink (msctf.h)

Artigo
08/24/2023

Instala um coletor de avisos.

Sintaxe

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

Parâmetros

[in] riid

Identifica o tipo de coletor de aconselhamento a ser instalado.

Esse parâmetro pode ser um dos seguintes valores quando o objeto ITfSource é obtido de um objeto ITfThreadMgr .

Esse parâmetro pode ser um dos valores a seguir quando o objeto ITfSource é obtido de um objeto ITfContext .

Valor	Significado
IID_ITfActiveLanguageProfileNotifySink	Instala um coletor de aconselhamento ITfActiveLanguageProfileNotifySink .
IID_ITfDisplayAttributeNotifySink	Instala um coletor de aconselhamento ITfDisplayAttributeNotifySink .
IID_ITfKeyTraceEventSink	Instala um coletor de aconselhamento ITfKeyTraceEventSink .
IID_ITfPreservedKeyNotifySink	Instala um coletor de aconselhamento ITfPreservedKeyNotifySink .
IID_ITfThreadFocusSink	Instala um coletor de aconselhamento ITfThreadFocusSink .
IID_ITfThreadMgrEventSink	Instala um coletor de aconselhamento ITfThreadMgrEventSink .

[in] punk

O ponteiro IUnknown do coletor aconselhável.

[out] pdwCookie

Endereço de um valor DWORD que recebe um cookie de identificação. Esse valor é usado para desinstalar o coletor de aconselhamento em uma chamada subsequente para ITfSource::UnadviseSink. Recebe (DWORD)-1 se ocorrer uma falha.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
CONNECT_E_CANNOTCONNECT	O coletor de aviso não pode ser instalado.
CONNECT_E_ADVISELIMIT	O número máximo de coletores de aviso foi atingido.
E_FAIL	Ocorreu um erro não especificado.
E_OUTOFMEMORY	Ocorreu uma falha de alocação de memória.

Requisitos


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