Método IModelObject::SetConcept (dbgmodel.h)

  • Artigo

O método SetConcept colocará um conceito especificado na instância de objeto especificada pelo ponteiro . Se um modelo pai anexado à instância de objeto especificada por isso também der suporte ao conceito, a implementação na instância substituirá no modelo pai.

Para obter o conjunto de conceitos (interfaces) compatíveis com o modelo de dados, consulte Conceitos do modelo de dados do depurador C++.

Para obter informações sobre a interface IKeyStore , consulte Interface IKeyStore.

Sintaxe

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

Parâmetros

conceptId

O identificador exclusivo do conceito que está sendo atribuído. Essa também é a IID da interface principal do conceito.

conceptInterface

A interface de conceito que está sendo atribuída (definida por conceptId).

conceptMetadata

Metadados opcionais a serem associados a esse conceito.

Retornar valor

Esse método retorna HRESULT que indica êxito ou falha.

Comentários

Exemplo de código

ComPtr<IModelObject> spObject; /* get an object: say a new one from CreateSyntheticObject */

// Implement IStringDisplayableConcept for the object.  Return a static "Hello World" string.
class MyStringConversion :
    public Microsoft::WRL::RuntimeClass<
        Microsoft::WRL::RuntimeClassFlags<Microsoft::WRL::RuntimeClassType::ClassicCom>,
        IStringDisplayableConcept
        >
{
public:

    IFACEMETHOD(ToDisplayString)(_In_ IModelObject * /*pContextObject*/, 
                                 _In_opt_ IKeyStore * /*pMetadata*/, 
                                 _Out_ BSTR *pDisplayString)
    {
        *pDisplayString = SysAllocString(L"Hello World");
        return *pDisplayString == nullptr ? E_OUTOFMEMORY : S_OK;
    }
};

// Add the implementation as a concept
ComPtr<MyStringConversion> spStringConverter = Microsoft::WRL::Make<MyStringConversion>();
if (spStringConverter != nullptr)
{
    if (SUCCEEDED(spObject->SetConcept(__uuidof(IStringDisplayableConcept),
                                       static_cast<IStringDisplayableConcept *>
                                           (spStringConverter.Get()), nullptr)))
    {
        // The new object can be converted to a string! 
    }
}

Requisitos

Requisito Valor
Cabeçalho dbgmodel.h

Confira também

Conceitos de C++ do modelo de dados do depurador

Interface IKeyStore

Interface IModelObject