Click or drag to resize

IMcObjectsAttachNotifySinkToCategory Method

Sets up to automatically attach either a standard (IID_IMcObjStandardNotify) or custom sink notification interface to any object which is added to a given category.

Namespace:  MediaCy.IQL.ObjectManager
Assembly:  MediaCy.IQL.ObjectManager (in MediaCy.IQL.ObjectManager.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Function AttachNotifySinkToCategory ( 
	varCategoryNameOrID As Object,
	varISinkIID As Object,
	piunkISink As Object
) As IntPtr

Parameters

varCategoryNameOrID
Type: SystemObject
[in] Category to auto attach to (see RegisterCategory).
varISinkIID
Type: SystemObject
[in]The ISink interface IID. This may be a VT_BSTR in which case the it must be the IID string in the form "{12345678-1234-1234-1234-123456789ABC}". If VT_I4 or VT_UI4, then it must be a cookie from a previous call to either AttachNotifySink or McObjects::AttachNotifySinkToCategory. If VT_EMPTY, a NULL pointer or IID_IMcObjStandardNotify, the notify sink is to be a standard one.
piunkISink
Type: SystemObject

Return Value

Type: IntPtr
Notify sink "cookie" identifier for this sink interface. This "cookie" value is the same for the same sink piunkINotifySink for all notify attach methods (McObject.AttachNotifySink, AttachNotifySinkToCategory and AttachNotifySinkToType).
Remarks
A McObject may be added to a category in two ways: explicitly by assigning to the McObject's Category property, or implicitly by a call to GetCategoryItem for an "auto add" item name registered by the AttachAutoAddToCategory method. In both of these cases, notify sinks attached here will be automatically added as notify sinks, just as if McObject.AttachNotifySink had been called. If any of the notify sinks attached are IMcObjStandardNotify sinks, then they will immediately receive an IMcObjStandardNotify.CategorySet notify method call.
Note Note
Sinks are notified when an mcobjTypeFlagAlias (see Add) object is added to a Category. This behavior differs from the notification set up by AttachNotifySinkToType, which ignores Alias type objects.
See Also