ITextStoreACP::UnadviseSink method (textstor.h)
The ITextStoreACP::UnadviseSink method is called by an application to indicate that it no longer requires notifications from the TSF manager. The TSF manager will release the sink interface and stop notifications.
HRESULT UnadviseSink( IUnknown *punk );
Pointer to a sink object. Cannot be NULL.
This method can return one of these values.
||The method was successful.|
||There is no active sink object.|
Every call to the ITextStoreAnchor::AdviseSink method, which registers a new sink object, should be matched by a call to this method. Calls to the ITextStoreAnchor::AdviseSink method that only update the dwMask parameter of a sink which was previously registered, do not require a call to the ITextStoreAnchor::UnadviseSink method.
For example, to register a sink object, an application calls the ITextStoreAnchor::AdviseSink method the first time. After registering the sink object, the application can call the ITextStoreAnchor::AdviseSink method again with the same sink object to change the dwMask parameter. To unregister the sink object, an application calls the ITextStoreAnchor::UnadviseSink method.
The punk parameter must have the same COM identity as the pointer originally passed in the ITextStoreAnchor::AdviseSink method.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Redistributable||TSF 1.0 on Windows 2000 Professional|