IDynamicConceptProviderConcept::GetConcept-Methode (dbgmodel.h)
Die GetConcept-Methode für einen dynamischen Konzeptanbieter ist effektiv eine Außerkraftsetzung der GetConcept-Methode für 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 für den Anbieter nicht vorhanden ist, muss dies über einen falsch zurückgegebenen Wert im hasConcept-Argument und einer erfolgreichen Rückgabe angegeben werden. Fehler dieser Methode ist ein Fehler beim Abrufen des Konzepts und wird die Suche nach dem Konzept explizit anhalten. Gibt "false" für hasConcept zurück, und ein erfolgreicher Code setzt die Suche nach dem Konzept über die übergeordnete Modellstruktur fort.
Syntax
HRESULT GetConcept(
IModelObject *contextObject,
REFIID conceptId,
IUnknown **conceptInterface,
IKeyStore **conceptMetadata,
bool *hasConcept
);
Parameter
contextObject
Das Instanzobjekt (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
Hier wird die kerne Schnittstelle zum Konzept zurückgegeben, wie durch das ConceptId-Argument definiert.
conceptMetadata
Alle Metadaten, die dem Konzept zugeordnet sind, können optional hier zurückgegeben werden.
hasConcept
Ein Hinweis darauf, ob der dynamische Anbieter das Konzept hier zurückgibt. Wenn der Anbieter nicht über das Konzept verfügt, sollte der Wert "false" hier zurückgegeben werden, und die Methode sollte erfolgreich sein.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |