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 |