ITextStoreACP::UnadviseSink-Methode (textstor.h)
Die ITextStoreACP::UnadviseSink-Methode wird von einer Anwendung aufgerufen, um anzugeben, dass sie keine Benachrichtigungen mehr vom TSF-Manager erfordert. 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 |
|---|---|
|
Die Methode war erfolgreich. |
|
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. Aufrufe der ITextStoreAnchor::AdviseSink-Methode , die nur den dwMask-Parameter einer zuvor registrierten Senke aktualisieren, erfordern keinen Aufruf der ITextStoreAnchor::UnadviseSink-Methode .
Um beispielsweise ein Senkenobjekt zu registrieren, ruft eine Anwendung zum ersten Mal die ITextStoreAnchor::AdviseSink-Methode auf. Nach der Registrierung des Senkenobjekts kann die Anwendung die ITextStoreAnchor::AdviseSink-Methode erneut mit demselben Senkenobjekt aufrufen, um den dwMask-Parameter zu ändern. Um die Registrierung des Senkenobjekts aufzuheben, ruft eine Anwendung die ITextStoreAnchor::UnadviseSink-Methode auf.
Der Punkparameter muss dieselbe COM-Identität aufweisen wie der Zeiger, der ursprünglich in der ITextStoreAnchor::AdviseSink-Methode übergeben wurde.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | textstor.h |
| DLL | Msctf.dll |
| Verteilbare Komponente | TSF 1.0 unter Windows 2000 Professional |