ITypeLib::GetTypeComp-Methode (oaidl.h)

  • Artikel

Ermöglicht es einem Clientcompiler, eine Bindung an die Typen, Variablen, Konstanten und globalen Funktionen für eine Bibliothek zu binden.

Syntax

HRESULT GetTypeComp(
  [out] ITypeComp **ppTComp
);

Parameter

[out] ppTComp

Die ITypeComp-instance für diese ITypeLib. Ein Clientcompiler verwendet die Methoden in der ITypeComp-Schnittstelle, um eine Bindung an Typen in ITypeLib sowie an die in ITypeLib definierten globalen Funktionen, Variablen und Konstanten zu binden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_INVALIDARG
Mindestens eines der Argumente ist ungültig.
E_OUTOFMEMORY
Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.

Hinweise

Die Bind-Funktion des zurückgegebenen TypeComp-Objekts wird an globale Funktionen, Variablen, Konstanten, aufgezählte Werte und Coklassenmember gebunden. Die Bind-Funktion bindet auch die Namen der TYPEKIND-Enumerationen von TKIND_MODULE, TKIND_ENUM und TKIND_COCLASS. Diese Namen überschatten alle globalen Namen, die in den Typinformationen definiert sind. Die Member von TKIND_ENUM-, TKIND_MODULE- und TKIND_COCLASS-Typen, die als Application-Objekte gekennzeichnet sind, können von ITypeComp direkt an gebunden werden, ohne den Namen des Moduls anzugeben.

ITypeComp::Bind und ITypeComp::BindType akzeptieren nur nicht qualifizierte Namen. ITypeLib::GetTypeComp gibt einen Zeiger auf die ITypeComp-Schnittstelle zurück, die dann zum Binden an globale Elemente in der Bibliothek verwendet wird. Die Namen einiger Typen (TKIND_ENUM, TKIND_MODULE und TKIND_COCLASS) teilen sich den Namensraum mit Variablen, Funktionen, Konstanten und Enumeratoren.

Wenn ein Member eine Qualifikation erfordert, um es von anderen Elementen im Namensraum zu unterscheiden, kann GetTypeComp für jeden Qualifizierer nacheinander aufgerufen werden, um an das gewünschte Element zu binden. Dadurch können Programmiersprachencompiler auf Member von Modulen, Enumerationen und Coklassen zugreifen, auch wenn der Member nicht mit einem qualifizierten Namen gebunden werden kann.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oaidl.h

Weitere Informationen

Itypelib