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

Artículo
03/08/2023

Instala un receptor de aviso.

Sintaxis

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

Parámetros

[in] riid

Identifica el tipo de receptor de asesoramiento que se va a instalar.

Este parámetro puede ser uno de los siguientes valores cuando el objeto ITfSource se obtiene de un objeto ITfThreadMgr .

Este parámetro puede ser uno de los siguientes valores cuando el objeto ITfSource se obtiene de un objeto ITfContext .

Valor	Significado
IID_ITfActiveLanguageProfileNotifySink	Instala un receptor ITfActiveLanguageProfileNotifySink .
IID_ITfDisplayAttributeNotifySink	Instala un receptor de asesoramiento ITfDisplayAttributeNotifySink .
IID_ITfKeyTraceEventSink	Instala un receptor ITfKeyTraceEventSink .
IID_ITfPreservedKeyNotifySink	Instala un receptor ITfPreservedKeyNotifySink .
IID_ITfThreadFocusSink	Instala un receptor ITfThreadFocusSink .
IID_ITfThreadMgrEventSink	Instala un receptor de asesoramiento ITfThreadMgrEventSink .

[in] punk

El puntero de aviso IUnknown .

[out] pdwCookie

Dirección de un valor DWORD que recibe una cookie de identificación. Este valor se usa para desinstalar el receptor de aviso en una llamada posterior a ITfSource::UnadviseSink. Recibe (DWORD)-1 si se produce un error.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	Uno o varios parámetros no son válidos.
CONNECT_E_CANNOTCONNECT	No se puede instalar el receptor de avisos.
CONNECT_E_ADVISELIMIT	Se ha alcanzado el número máximo de receptores de aviso.
E_FAIL	Se ha producido un error no especificado.
E_OUTOFMEMORY	Error de asignación de memoria.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional