System.Runtime.InteropServices.ExtensibleClassFactory Class

Enables customization of managed objects that extend from unmanaged objects during creation.

See Also: ExtensibleClassFactory Members

Syntax

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ExtensibleClassFactory

Remarks

The ExtensibleClassFactory allows users to specify a delegate that is called during construction of a runtime callable wrapper (RCW) that provides an instance of the underlying COM object. In effect, the callback acts as the class factory for the COM object wrapped by the RCW. Without the callback, the common language runtime creates the underlying COM object by calling CoCreateInstance. This callback provides an alternative way of activating the underlying object, such as with a COM moniker or by providing a singleton object. The ExtensibleClassFactory.RegisterObjectCreationCallback(ObjectCreationDelegate) method must be called in the static initializer of the class that is extending the RCW. Only one object creation callback is permitted per object type. When the extensible RCW is activated, the callback is registered. When the underlying COM object needs to be created, the callback is called to provide a reference to the object. The callback must return an IUnknown interface pointer for the base object.

Requirements

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0