Freigeben über


ITextStoreAnchor::UnadviseSink-Methode (textstor.h)

Wird von einer Anwendung aufgerufen, um anzugeben, dass keine Benachrichtigungen mehr vom TSF-Manager erforderlich sind.

Syntax

HRESULT UnadviseSink(
  [in] IUnknown *punk
);

Parameter

[in] punk

Zeiger auf ein Senkenobjekt. Kann nicht NULL sein.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
CONNECT_E_NOCONNECTION
Es gibt kein aktives Senkenobjekt.

Hinweise

Jeder Aufruf der ITextStoreAnchor::AdviseSink-Methode , die ein neues Senkenobjekt registriert, sollte durch einen Aufruf dieser Methode abgeglichen werden. Wenn AdviseSink nur den dwMask-Parameter einer zuvor registrierten Senke aktualisiert hat, ist kein Aufruf von UnadviseSink erforderlich.

Beispielsweise ruft eine Anwendung zum ersten Mal die AdviseSink-Methode auf, um ein Senkenobjekt zu registrieren. Die Anwendung kann dann die AdviseSink-Methode erneut mit demselben Senkenobjekt aufrufen, um den dwMask-Parameter zu ändern. Um die Registrierung des Senkenobjekts aufzuheben, ruft eine Anwendung die UnadviseSink-Methode auf.

Der Punkparameter muss dieselbe COM-Identität aufweisen wie der Zeiger, der ursprünglich in der AdviseSink-Methode übergeben wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile textstor.h
DLL Msctf.dll
Verteilbare Komponente TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITextStoreAnchor

ITextStoreAnchor::AdviseSink