IModelObject ::GetConcept, méthode (dbgmodel.h)

Article
02/06/2025

La méthode GetConcept recherche un concept sur l’objet (ou sa chaîne de modèle parent) et retourne un pointeur d’interface vers l’interface de concept. Le comportement et les méthodes d’une interface de concept sont spécifiques à chaque concept. Toutefois, il est important de noter que de nombreuses interfaces de concept nécessitent que l’appelant passe explicitement l’objet de contexte (ou ce qu’on peut appeler traditionnellement ce pointeur). Il est important de s’assurer que l’objet de contexte approprié est passé à chaque interface de concept.

Syntaxe

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

Paramètres

conceptId

Identificateur unique du concept interrogé. Il s’agit également de l’IID de l’interface principale du concept.

conceptInterface

L’interface définie par conceptId est retournée dans cet argument.

conceptMetadata

Le magasin de métadonnées associé à ce concept sera éventuellement retourné dans cet argument.

Valeur de retour

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

Exemple de code

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);
    }
}

Exigences

Exigence	Valeur
d’en-tête	dbgmodel.h

Voir aussi

interface IModelObject

Partager via