Freigeben über


IDynamicConceptProviderConcept::GetConcept-Methode (dbgmodel.h)

Die GetConcept-Methode für einen dynamischen Konzeptanbieter ist effektiv eine Überschreibung der GetConcept-Methode auf IModelObject. Der dynamische Konzeptanbieter muss eine Schnittstelle für das abgefragte Konzept zurückgeben, sofern es vorhanden ist, sowie alle metadaten, die diesem Konzept zugeordnet sind. Wenn das Konzept auf dem Anbieter nicht vorhanden ist, muss dies über einen false-Wert angegeben werden, der im hasConcept-Argument zurückgegeben wird, und eine erfolgreiche Rückgabe. Der Fehler dieser Methode ist ein Fehler beim Abrufen des Konzepts und wird die Suche nach dem Konzept explizit angehalten. Durch zurückgeben von false für hasConcept und einem erfolgreichen Code wird die Suche nach dem Konzept über die übergeordnete Modellstruktur fortgesetzt.

Syntax

HRESULT GetConcept(
  IModelObject *contextObject,
  REFIID       conceptId,
  IUnknown     **conceptInterface,
  IKeyStore    **conceptMetadata,
  bool         *hasConcept
);

Parameter

contextObject

Das instance -Objekt (dieser Zeiger), für das ein Konzept abgerufen werden soll.

conceptId

Die GUID, die das erworbene Konzept identifiziert. Diese GUID identifiziert sowohl das Konzept als auch die Kernschnittstelle des Konzepts eindeutig. Es ist die Schnittstellen-ID (IID) der primären Schnittstelle für ein definiertes Konzept.

conceptInterface

Die kernhafte Schnittstelle zum Konzept, wie sie durch das conceptId-Argument definiert wird, wird hier zurückgegeben.

conceptMetadata

Alle Metadaten, die dem Konzept zugeordnet sind, können hier optional zurückgegeben werden.

hasConcept

Hier wird ein Hinweis darauf zurückgegeben, ob der dynamische Anbieter über das Konzept verfügt. Wenn der Anbieter nicht über das Konzept verfügt, sollte hier der Wert false zurückgegeben werden, und die Methode sollte erfolgreich sein.

Rückgabewert

Diese Methode gibt HRESULT zurück, was auf Erfolg oder Fehler hinweist.

Anforderungen

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IDynamicConceptProviderConcept-Schnittstelle