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 |