IDebugComPlusSymbolProvider2::GetTypesByName

检索给定其名称的类型。

语法

int GetTypesByName(
    string               pszClassName,
    enum_ NAME_MATCH     nameMatch,
    out IEnumDebugFields ppEnum
);

参数

pszClassName
[in]类型的名称。

nameMatch
[in]选择匹配类型,例如区分大小写。 NAME_MATCH枚举中的值。

ppEnum
[out]包含具有给定名称的类型或类型的枚举器。

返回值

如果成功,则返回 S_OK;否则,返回错误代码。

注解

对于泛型类型,要查找“List int”或“List<int>>”的名称将是“List<”。 如果同名的类型出现在多个模块中,该 ppEnum 参数将包含所有副本。 必须使用 GetTypeInfo 并根据参数进行区分 guidModule

示例

以下示例演示如何为公开 IDebugComPlusSymbolProvider2 接口的 CDebugSymbolProvider 对象实现此方法。

HRESULT CDebugSymbolProvider::GetTypesByName(
    LPCOLESTR pszClassName,
    NAME_MATCH nameMatch,
    IEnumDebugFields** ppEnum
)
{
    HRESULT hr = S_OK;
    CModIter ModIter;
    CModule* pmodule; // the iterator owns the reference
    CFieldList listField;

    ASSERT(IsValidWideStringPtr(pszClassName));
    ASSERT(IsValidWritePtr(ppEnum, IEnumDebugFields*));

    METHOD_ENTRY( CDebugSymbolProvider::GetTypesByName );

    IfFalseGo( pszClassName && ppEnum, E_INVALIDARG );
    *ppEnum = NULL;

    IfFailGo( GetModuleIter(&ModIter) );

    hr = S_FALSE;

    if ( nameMatch == nmCaseInsensitive)
    {
        while (ModIter.GetNext(&pmodule))
        {
            if (pmodule->FindTypesByNameCaseInsensitive( pszClassName,
                    &listField,
                    this ) )
            {
                hr = S_OK;
            }
        }
    }
    else
    {
        while (ModIter.GetNext(&pmodule))
        {
            if (pmodule->FindTypesByName( pszClassName,
                                          &listField,
                                          this) )
            {
                hr = S_OK;
            }
        }
    }

    // If the list is empty then no type
    IfFalseGo( listField.GetCount(), E_FAIL );

    // Create enumerator
    IfFailGo( CreateEnumerator( ppEnum, &listField ) );

Error:

    METHOD_EXIT( CDebugSymbolProvider::GetTypesByName, hr );

    return hr;
}

另请参阅