Freigeben über


ITextStoreACP2::UnadviseSink-Methode (textstor.h)

Wird von einer Anwendung aufgerufen, um anzugeben, dass keine Benachrichtigungen mehr vom TSF-Manager erforderlich sind. Der TSF-Manager gibt die Senkenschnittstelle frei und beendet Benachrichtigungen.

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 AdviseSink-Methode , die ein neues Senkenobjekt registriert, sollte durch einen Aufruf dieser Methode abgeglichen werden. Aufrufe der AdviseSink-Methode , die nur den dwMask-Parameter einer zuvor registrierten Senke aktualisieren, erfordern keinen Aufruf der UnadviseSink-Methode .

Beispielsweise ruft eine Anwendung zum ersten Mal die AdviseSink-Methode auf, um ein Senkenobjekt zu registrieren. Nach der Registrierung des Senkenobjekts kann die Anwendung die AdviseSink-Methode mit demselben Senkenobjekt erneut 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

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile textstor.h
DLL Msctf.dll

Weitere Informationen

AdviseSink

ITextStoreACP2