IDataModelManager3::GetModelForType 方法 (dbgmodel.h)

GetModelForType 方法返回数据模型,该模型是给定类型实例的规范可视化工具。 实际上,此方法查找与 RegisterModelForTypeSignature 方法之前调用注册的最佳匹配类型签名,并返回关联的数据模型。

语法

HRESULT GetModelForType(
  IDebugHostType             *type,
  IModelObject               **dataModel,
  IDebugHostTypeSignature    **typeSignature,
  IDebugHostSymbolEnumerator **wildcardMatches
);

参数

type

具体类型实例,用于查找通过之前调用 RegisterModelForTypeSignature 方法注册的最佳匹配规范可视化工具。

dataModel

此处将返回由通过之前调用 RegisterModelForTypeSignature 注册的最佳匹配类型签名确定的给定类型实例规范可视化工具的数据模型。 此数据模型将自动附加到使用类型参数指定的类型创建的任何本机/语言对象。

typeSignature

与类型匹配的类型签名导致我们从之前调用 RegisterModelForTypeSignature 中注册的数据模型返回返回返回的类型签名。

wildcardMatches

如果 typeSignature 参数中返回的签名中有通配符,则会在此处返回通配符和类型参数中指定的具体类型实例之间的所有匹配项的枚举数。

返回值

此方法返回指示成功或失败的 HRESULT。

言论

示例代码

ComPtr<IDataModelManager3> spManager; /* get the data model manager */
ComPtr<IDebugHostModule> spModule;   /* get a module */

// Find the type of "MyType<int>" within the module
ComPtr<IDebugHostType> spType;
if (SUCCEEDED(spModule->FindTypeByName(L"MyType<int>", &spType)))
{
    // Find the canonical visualizer which would be applied to MyType<int>
    ComPtr<IModelObject> spDataModel;
    ComPtr<IDebugHostTypeSignature> spSignature;
    ComPtr<IDebugHostSymbolEnumerator> spWildcardMatches;

    if (SUCCEEDED(spManager->GetModelForType(spType.Get(), 
                                             &spDataModel, 
                                             &spSignature, 
                                             &spWildcardMatches)))
    {
        // There is a visualizer which matched.
        // spDataModel is the data model object which was registered as 
        //     the canonical visualizer (RegisterModelForTypeSignature)
        // spSignature is the signature which that data model was registered 
        //     against (e.g.: created for MyType<*> via
        //     CreateTypeSignature/RegisterModelForTypeSignature)
        // spWildcardMatches is an enumerator of the wildcard matches between 
        //     the specific type spType and the signature spSignature (here 
        //     int matched *, so there will be one item -- the type 'int' in
        //     the enumerator)
    }

要求

要求 价值
标头 dbgmodel.h

另请参阅

IDataModelManager3 接口