System.Win.ComObj.TClassInstancing

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TClassInstancing = (ciInternal, ciSingleInstance, ciMultiInstance);

C++

enum DECLSPEC_DENUM TClassInstancing : unsigned char { ciInternal, ciSingleInstance, ciMultiInstance };

Properties

Type Visibility Source Unit Parent
enum public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj System.Win.ComObj

Description

UTClassInstancing determines how COM objects are instantiated.

TClassInstancing indicates the process space in which a COM factory can instantiate COM objects and whether a single process can create more than one instance. The following table lists the possible values of the TClassInstancing type:



Value Meaning

ciInternal

The COM object is created by the same process as the COM server. That is, an external application cannot create an instance of this object directly. Instead, external processes must call a method of the application that creates the document object.

ciSingleInstance

Allows only a single instance of the COM object for each executable (application). If this single instance is not shared across multiple clients, then each client must launch its own instance of the executable.

ciMultiInstance

The COM object is created as one of multiple instances within the same executable. Any time a client requests service, a separate instance of the object gets invoked.