ITextStoreAnchor::UnadviseSink method (textstor.h)
Called by an application to indicate that it no longer requires notifications from the TSF manager.
Syntax
HRESULT UnadviseSink(
[in] IUnknown *punk
);
Parameters
[in] punk
Pointer to a sink object. Cannot be NULL.
Return value
This method can return one of these values.
Value | Description |
---|---|
|
The method was successful. |
|
There is no active sink object. |
Remarks
Every call to the ITextStoreAnchor::AdviseSink method, which registers a new sink object, should be matched by a call to this method. If AdviseSink has only updated the dwMask parameter of a sink which was previously registered, a call to UnadviseSink is not required.
For example, to register a sink object, an application calls the AdviseSink method the first time. The application can then call the AdviseSink method again with the same sink object to change the dwMask parameter. To unregister the sink object, an application calls the UnadviseSink method.
The punk parameter must have the same COM identity as the pointer originally passed in the AdviseSink method.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps | UWP apps] |
Minimum supported server | Windows 2000 Server [desktop apps | UWP apps] |
Target Platform | Windows |
Header | textstor.h |
DLL | Msctf.dll |
Redistributable | TSF 1.0 on Windows 2000 Professional |