Objektzuordnungs-Makros

Diese Makros definieren Objektzuordnungen und Einträge.

Name	Beschreibung
DECLARE_OBJECT_DESCRIPTION	Ermöglicht es Ihnen, die Textbeschreibung eines Klassenobjekts anzugeben, die in die Objektzuordnung eingegeben wird.
OBJECT_ENTRY_AUTO	Gibt ein ATL-Objekt in die Objektzuordnung ein, aktualisiert die Registrierung und erstellt eine Instanz des Objekts.
OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO	Ermöglicht es Ihnen, anzugeben, dass das Objekt registriert und initialisiert werden sollte, jedoch nicht extern über CoCreateInstance erstellbar sein sollte.

Anforderungen

Kopfzeile: atlcom.h

DECLARE_OBJECT_DESCRIPTION

Ermöglicht es Ihnen, eine Textbeschreibung für Ihr Klassenobjekt anzugeben.

DECLARE_OBJECT_DESCRIPTION( x )

Parameter

x
[in] Beschreibung des Klassenobjekts.

Hinweise

ATL gibt diese Beschreibung über das OBJECT_ENTRY_AUTO Makro in die Objektzuordnung ein.

DECLARE_OBJECT_DESCRIPTION implementiert eine GetObjectDescription Funktion, mit der Sie die CComCoClass::GetObjectDescription-Methode überschreiben können.

Die GetObjectDescription Funktion wird von IComponentRegistrar::GetComponents. IComponentRegistrar ist eine Automatisierungsschnittstelle, mit der Sie einzelne Komponenten in einer DLL registrieren und aufheben können. Wenn Sie ein Komponentenregistrierungsstellenobjekt mit dem ATL-Projekt-Assistenten erstellen, implementiert der Assistent automatisch die IComponentRegistrar Schnittstelle. IComponentRegistrar wird in der Regel von Microsoft Transaction Server verwendet.

Weitere Informationen zum ATL-Projekt-Assistenten finden Sie im Artikel Erstellen eines ATL-Projekts.

Beispiel

class ATL_NO_VTABLE CMyDescribedClass :
   public CComObjectRoot,
   public CComCoClass<CMyDescribedClass, &CLSID_MyDescribedClass>
{
public:
   CMyDescribedClass()
   {
   }

   // Override CComCoClass::GetObjectDescription
   DECLARE_OBJECT_DESCRIPTION("My Described Object 1.0")
};

OBJECT_ENTRY_AUTO

Gibt ein ATL-Objekt in die Objektzuordnung ein, aktualisiert die Registrierung und erstellt eine Instanz des Objekts.

OBJECT_ENTRY_AUTO( clsid, class )

Parameter

Clsid
[in] Die CLSID einer COM-Klasse, die von der C++-Klasse namens klasse implementiert wird.

class
[in] Der Name der C++-Klasse, die die durch clsid dargestellte COM-Klasse implementiert.

Hinweise

Objekt-Eintragsmakros befinden sich im globalen Gültigkeitsbereich des Projekts, um Unterstützung für die Registrierung, Initialisierung und Erstellung einer neuen Klasse bereitzustellen.

OBJECT_ENTRY_AUTO die Funktionszeiger der Erstellerklasse und der Klassenfactory-Erstellerklassenfunktionen CreateInstance für dieses Objekt in die automatisch generierte ATL-Objektzuordnung eingeben. Wenn CAtlComModule::RegisterServer aufgerufen wird, wird die Systemregistrierung für jedes Objekt in der Objektzuordnung aktualisiert.

In der folgenden Tabelle wird beschrieben, wie die Informationen, die der Objektzuordnung hinzugefügt werden, aus der Klasse abgerufen werden, die als zweiter Parameter zu diesem Makro angegeben wird.

Informationen für	Erhalten von
COM-Registrierung	Registrierungsmakros
Erstellen von Klassenfabriken	Klassenfactorymakros
Erstellen einer Instanz	Aggregationsmakros
Komponentenkategorieregistrierung	Kategorie-Makros
Initialisierung auf Klassenebene und sauber up	ObjectMain

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO

Ermöglicht es Ihnen, anzugeben, dass das Objekt registriert und initialisiert werden sollte, jedoch nicht extern über CoCreateInstance erstellbar sein sollte.

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO( clsid, class )

Parameter

Clsid
[in] Die CLSID einer COM-Klasse, die von der C++-Klasse namens klasse implementiert wird.

class
[in] Der Name der C++-Klasse, die die durch clsid dargestellte COM-Klasse implementiert.

Hinweise

Objekt-Eintragsmakros befinden sich im globalen Gültigkeitsbereich des Projekts, um Unterstützung für die Registrierung, Initialisierung und Erstellung einer neuen Klasse bereitzustellen.

mit OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO können Sie angeben, dass ein Objekt registriert und initialisiert werden soll (weitere Informationen finden Sie unter OBJECT_ENTRY_AUTO ), aber es sollte nicht über CoCreateInstancedas Objekt erstellt werden können.

Siehe auch

Makros