Freigeben über


IModelObject::GetConcept-Methode (dbgmodel.h)

Die GetConcept-Methode sucht nach einem Konzept für das Objekt (oder dessen übergeordnete Modellkette) und gibt einen Schnittstellenzeiger auf die Konzeptschnittstelle zurück. Das Verhalten und die Methoden für eine Konzeptschnittstelle sind für jedes Konzept spezifisch. Es ist jedoch wichtig zu beachten, dass viele der Konzeptschnittstellen erfordern, dass der Aufrufer das Kontextobjekt explizit übergeben muss (oder was man normalerweise als diesen Zeiger bezeichnen könnte). Es ist wichtig, sicherzustellen, dass das richtige Kontextobjekt an jede Konzeptschnittstelle übergeben wird.

Syntax

HRESULT GetConcept(
  REFIID    conceptId,
  IUnknown  **conceptInterface,
  IKeyStore **conceptMetadata
);

Parameter

conceptId

Der eindeutige Bezeichner des abgefragten Konzepts. Dies ist auch die IID der Kernschnittstelle des Konzepts.

conceptInterface

Die von conceptId definierte Schnittstelle wird in diesem Argument zurückgegeben.

conceptMetadata

Der diesem Konzept zugeordnete Metadatenspeicher wird in diesem Argument optional zurückgegeben.

Rückgabewert

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

Hinweise

Codebeispiel

ComPtr<IModelObject> spObject; /* get some object */

// Get the string conversion of spObject through the string displayable concept:
ComPtr<IStringDisplayableConcept> spStringDisplayable;
if (SUCCEEDED(spObject->GetConcept(__uuidof(IStringDisplayableConcept), 
                                   &spStringDisplayable, 
                                   nullptr)))
{
    BSTR stringConversion;
    if (SUCCEEDED(spStringDisplayable->ToDisplayString(spObject.Get(), 
                                                       nullptr, 
                                                       &stringConversion)))
    {
        // stringConversion contains the display string conversion for the object
        SysFreeString(stringConversion);
    }
}

Anforderungen

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IModelObject-Schnittstelle