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 |
|---|---|
|
Método realizado correctamente. |
|
No se pudo obtener el riid de interfaz de receptor especificado. |
|
No se admite la interfaz de receptor especificada. |
|
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 |