System.Variant.CreateObject
C++
static Variant __fastcall CreateObject(const String& ProgID);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | sysvari.h | System | Variant |
Description
Crée un objet OLE Automation avec l'identificateur de programme spécifié par ProgID et le renvoie sous forme de Variant.
CreateObject crée un objet non initialisé unique de la classe associée au ProgID spécifié par le paramètre ProgID. CreateObject permet de créer un objet d'un type spécifié lorsque le ProgID est connu et lorsque l'objet est sur un serveur local ou en processus. Les objets ne faisant pas partie d'un agrégat sont les seuls à être créés par CreateObject.
CreateObject est appelée une seule fois pour créer chaque nouvelle instance unique d'une classe. Pour créer plusieurs instances de la même classe, il est recommandé d'utiliser une fabrique de classe.
CreateObject renvoie une référence sur l'identificateur de l'interface à utiliser pour communiquer avec l'objet. Pour CreateObject, cette interface est de type IDispatch.
Si ProgID est incorrect, CreateObject déclenche une exception EOleSysError.