Метод IDataModelManager::UnregisterModelForTypeSignature (dbgmodel.h)

Статья
08/07/2023

Метод UnregisterModelForTypeSignature отменяет предыдущий вызов метода RegisterModelForTypeSignature. Этот метод может либо удалить заданную модель данных в качестве канонического визуализатора для типов, соответствующих определенной сигнатуре типа, либо удалить данную модель данных как канонический визуализатор для каждой сигнатуры типа, под которой зарегистрирована эта модель данных.

Синтаксис

HRESULT UnregisterModelForTypeSignature(
  IModelObject            *dataModel,
  IDebugHostTypeSignature *typeSignature
);

Параметры

dataModel

Модель данных, отменяемая регистрация в качестве канонического визуализатора для одной или нескольких сигнатур типа. Если аргумент typeSignature имеет значение nullptr, эта модель данных будет отменена во всех сигнатурах типов, для которые она была зарегистрирована; В противном случае он будет отменен только для указанной сигнатуры конкретного типа.

typeSignature

Сигнатура типа, для которой модель данных, заданная аргументом dataModel, будет отменена регистрация. Этот аргумент является необязательным, поэтому можно передать nullptr. Если передается значение nullptr, модель данных, заданная аргументом dataModel, будет отменена регистрация всех сигнатур типов, для которые она была зарегистрирована.

Возвращаемое значение

Этот метод возвращает HRESULT, указывающее на успех или сбой.

ComPtr<IDataModelManager> spManager;             /* get the data model manager */
ComPtr<IDebugHostTypeSignature> spTypeSignature; /* get a type signature (see
                                                    RegisterModelForTypeSignature) */
ComPtr<IModelObject> spDataModelObject;          /* get a data model object (see
                                                    CreateDataModelObject) */

if (SUCCEEDED(spManager->UnregisterModelForTypeSignature(spDataModelObject.Get(),
                                                         spTypeSignature.Get())))
{
    // spDataModelObject is no longer registered as the canonical visualizer
    // for types matching the signature.  Note that if the second argument were 
    // passed as 'nullptr', spDataModelObject would no longer be registered 
    // as the canonical visualizer for *ANY* types.
}

Требования

Требование	Значение
Заголовок	dbgmodel.h

См. также раздел

Интерфейс IDataModelManager

Поделиться через