Método ITextStoreAnchor::AdviseSink (textstor.h)

El método ITextStoreAnchor::AdviseSink instala un nuevo receptor de aviso desde la interfaz ITextStoreAnchorSink o modifica un receptor de aviso existente.

Sintaxis

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

Parámetros

[in] riid

Especifica la interfaz del receptor. El único valor admitido es IID_ITextStoreAnchorSink.

[in] punk

Puntero a la interfaz del receptor que se recomienda. No puede ser NULL.

[in] dwMask

Especifica los eventos que notifican al receptor de aviso. Para obtener más información sobre los posibles valores de parámetro, vea constantes TS_AS_*.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	No se pudo obtener el riid de interfaz de receptor especificado.
E_INVALIDARG	No se admite la interfaz de receptor especificada.
E_UNEXPECTED	No se pudo obtener el objeto receptor especificado.

Comentarios

Las llamadas posteriores con la misma interfaz, representadas por el parámetro punk , se controlan como solicitudes para actualizar el parámetro dwMask . Los servidores no deben llamar al método AddRef en el receptor en respuesta a dicha solicitud.

Los servidores solo mantienen un único punto de conexión. Se produce un error en los intentos de avisar a un segundo objeto receptor hasta que se quite el objeto receptor original. Las aplicaciones deben usar el método ITextStoreAnchor::UnadviseSink para anular el registro del objeto receptor cuando no se requieren notificaciones.

Requisitos

Requisito	Value
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	textstor.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

ITextStoreAnchor

ITextStoreAnchor::UnadviseSink

TS_AS_* (constantes)