Share via

ISpNotifySource::SetNotifySink

  • Article

This method sets up an ISpNotifySource object to make free-threaded notification calls through ISpNotifySink::Notify. Because free-threaded notifications can occur on any thread at any point during execution, they are extremely prone to deadlocks and re-entrancy problems. See the documentation for ISpNotifySink for more details. Most applications will find using one of the other notification mechanisms much easier to use.

HRESULT SetNotifySink(
  ISpNotifySink* pNotifySink
);

Parameters

  • pNotifySink
    [in] Pointer to ISpNotifySink for the current notify sink. If pNotifySink is NULL, any current notification mechanism (notify sink, window message, callback, or Win32 event) is removed.

Return Values

The following table shows the possible return values.

Value Description
S_OK Function completed successfully.
E_INVALIDARG Interface pointer is invalid.
FAILED(hr) Appropriate error message.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.

See Also

ISpNotifySource | SAPI Interfaces

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.