IDiaTable

枚举 DIA 数据源表。

IDiaTable : IEnumUnknown

方法按 Vtable 顺序

下表显示 IDiaTable方法。

方法

说明

IDiaTable::get__NewEnum

检索此枚举器的 IEnumVARIANT Interface 版本。

IDiaTable::get_name

检索该表的名称。

IDiaTable::get_Count

在表中检索项的数目。

IDiaTable::Item

检索对特定项索引。

备注

此接口对 Microsoft.VisualStudio.OLE.Interop 命名空间的 IEnumUnknown 枚举方法。IEnumUnknown 枚举接口用于重复比 IDiaTable::get_CountIDiaTable::Item 方法是有效在表内容。

IDiaTable::Item 方法或 Next 方法返回的 IUnknown 接口的说明 (在 Microsoft.VisualStudio.OLE.Interop 命名空间) 依赖于表的类型。例如,因此,如果 IDiaTable 接口表示插入的列表中,应为 IDiaInjectedSource 接口查询 IUnknown 接口。

调用方的说明

通过调用 IDiaEnumTables::ItemIDiaEnumTables::Next 方法获取此接口。

下列接口实现与 IDiaTable 接口 (即可以查询以下接口之一的 IDiaTable 接口):

示例

第一个函数, ShowTableNames,在会话中显示所有表的名称。第二个函数, GetTable,搜索所有表实现了指定接口的表。第三个函数, UseTable,演示如何使用 GetTable 功能。

说明说明

CDiaBSTR 是包装释放字符串的 BSTR 和自动处理的类,在这个实例化超出范围。

void ShowTableNames(IDiaSession *pSession)
{
    CComPtr<IDiaEnumTables> pTables;
    if ( FAILED( psession->getEnumTables( &pTables ) ) )
    {
        Fatal( "getEnumTables" );
    }
    CComPtr< IDiaTable > pTable;
    while ( SUCCEEDED( hr = pTables->Next( 1, &pTable, &celt ) )
            && celt == 1 )
    {
        CDiaBSTR bstrTableName;
        if ( pTable->get_name( &bstrTableName ) != 0 )
        {
            Fatal( "get_name" );
        }
        printf( "Found table: %ws\n", bstrTableName );
    }


// Searches the list of all tables for a table that supports
// the specified interface.  Use this function to obtain an
// enumeration interface.
HRESULT GetTable(IDiaSession* pSession,
                 REFIID       iid,
                 void**       ppUnk)
{
    CComPtr<IDiaEnumTables> pEnumTables;
    HRESULT hResult;

    if (FAILED(pSession->getEnumTables(&pEnumTables)))
        Fatal("getEnumTables");

    CComPtr<IDiaTable> pTable;
    ULONG celt = 0;
    while (SUCCEEDED(hResult = pEnumTables->Next(1, &pTable, &celt)) &&
           celt == 1)
    {
        if (pTable->QueryInterface(iid, (void**)ppUnk) == S_OK)
        {
            return S_OK;
        }
        pTable = NULL;
    }

    if (FAILED(hResult))
        Fatal("EnumTables->Next");

    return E_FAIL;
}


// This function shows how to use the GetTable function.
void UseTable(IDiaSession *pSession)
{
    CComPtr<IDiaEnumSegments> pEnumSegments;
    if (SUCCEEDED(GetTable(pSession, __uuidof(IDiaEnumSegments), &pEnumSegments)))
    {
        // Do something with pEnumSegments.
    }
}

要求

标题:Dia2.h

库:diaguids.lib

DLL:msdia80.dll

请参见

参考

IDiaEnumTables

IDiaEnumTables::Item

IDiaEnumTables::Next

其他资源

接口(调试接口访问 SDK)