FireStandardNotifyToAllSinks Method

Description

A notify is fired to all standard (IID_IMcObjStandardNotify) sink interfaces currently attached to the object.

Return Type

A Boolean value.

TRUE if a SpecialNotify aborted the notify loop by returning S_FALSE. Otherwise returns FALSE.

Syntax

object.FireStandardNotifyToAllSinks ([lNotifyCode], [varNotifyData])

The FireStandardNotifyToAllSinks Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McObject.
lNotifyCode	Optional. A Long value. If zero, an IStandardNotify::ValueChanged call is made to all sinks and the varNotifyData argument is ignored. If non-zero, an IStandardNotify::SpecialNotify(pmcObj,lNofifyCode, varNotifyData) call is made to all sinks.
varNotifyData	Optional. A Variant value. Any data to be passed along with a non-zero lNotifyCode in each IStandardNotify::SpecialNotify call.

Remarks

The notify fired may be either an IStandardNotify::ValueChanged call or an McObjStandardNotify::SpecialNotify, depending on whether the lNotifyCode argument is zero or not.

A SpecialNotify sink (lNotifyCode non-zero), may abort the notification loop by returning S_FALSE. This will prevent any remaining attached sinks from receiving the notifcation. Attached owner sinks are notified in the order they were attached unless McObjects.SetNotifyOrder has been called.

See AttachNotifySink for an explaination of notify-related issues.