Compartilhar via


Método ITextStoreACP::UnadviseSink (textstor.h)

O método ITextStoreACP::UnadviseSink é chamado por um aplicativo para indicar que ele não exige mais notificações do gerenciador do TSF. O gerenciador do TSF liberará a interface do coletor e interromperá as notificações.

Sintaxe

HRESULT UnadviseSink(
  [in] IUnknown *punk
);

Parâmetros

[in] punk

Ponteiro para um objeto de coletor. Não pode ser NULL.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
CONNECT_E_NOCONNECTION
Não há nenhum objeto de coletor ativo.

Comentários

Cada chamada para o método ITextStoreAnchor::AdviseSink , que registra um novo objeto de coletor, deve ser correspondida por uma chamada a esse método. Chamadas para o método ITextStoreAnchor::AdviseSink que atualizam apenas o parâmetro dwMask de um coletor que foi registrado anteriormente, não exigem uma chamada para o método ITextStoreAnchor::UnadviseSink .

Por exemplo, para registrar um objeto de coletor, um aplicativo chama o método ITextStoreAnchor::AdviseSink pela primeira vez. Depois de registrar o objeto coletor, o aplicativo pode chamar o método ITextStoreAnchor::AdviseSink novamente com o mesmo objeto coletor para alterar o parâmetro dwMask . Para cancelar o registro do objeto coletor, um aplicativo chama o método ITextStoreAnchor::UnadviseSink .

O parâmetro punk deve ter a mesma identidade COM que o ponteiro originalmente passado no método ITextStoreAnchor::AdviseSink .

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 textstor.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Itextstoreacp

ITextStoreACP::AdviseSink