noncreatable-Attribut

Das [ nicht erstellbare Attribut ] definiert ein Objekt, das nicht selbst instanziiert werden kann.

[
  coclass-attribute-list, 
    noncreatable
]
coclass coclass-name
{
  coclass-interface-list
}

Parameter

coclass-attribute-list

Andere Attribute, die für die -Klasse gelten.

coclass-name

Der Name der Klasse.

coclass-interface-list

Eine Liste der Schnittstellen für die -Klasse.

Bemerkungen

Use the [noncreatable] attribute on a coclass statement to indicate to users that they cannot create a new object of this class at the top level—that is, by calling CreateInstance or CoCreateInstance. Die Instanziierung eines Objekts dieser Klasse erfordert einen Methodenaufruf an ein anderes Objekt. In diesem Beispiel Microsoft Excel das "Cell"-Objekt nicht erstellt werden und muss aus einem arbeitsblatt Microsoft Excel objekt erhalten werden.

Methoden, die Instanzen von nicht erstellbaren Klassen zurückgeben, sollten anstelle von VARIANT- oder IDispatch-Typen den genauen Typ des Objekts * zurückgeben.

Typflagdarstellung:

Das Fehlen von TYPEFLAG _ FCANCREATE.

Beispiele

[
    uuid(12345678-1234-1234-1234-123456789ABC),
    helpstring("This is MyCOClass"),
    noncreatable
]
coclass MyCoClass
{
    [default] interface IMyClass;
    [default, source] dispinterface IMyClassEvents;
}

Weitere Informationen

coclass

ODL-Dateisyntax

ODL-Dateibeispiel

Generieren einer Typbibliothek mit MIDL