IDiaEnumFrameData

Статья
06/14/2024

Перечисляет различные элементы данных кадра, содержащиеся в источнике данных.

Синтаксис

IDiaEnumFrameData : IUnknown

Методы в порядке таблицы Vtable

В следующей таблице показаны методы IDiaEnumFrameData.

Метод	Description
IDiaEnumFrameData::get__NewEnum	Извлекает `IEnumVARIANT Interface` версию этого перечислителя.
IDiaEnumFrameData::get_Count	Извлекает количество элементов данных кадра.
IDiaEnumFrameData::Item	Извлекает элемент данных кадра с помощью индекса.
IDiaEnumFrameData::Next	Извлекает указанное количество элементов данных кадра в последовательности перечисления.
IDiaEnumFrameData::Skip	Пропускает указанное количество элементов данных кадра в последовательности перечисления.
IDiaEnumFrameData::Reset	Сбрасывает последовательность перечисления в начало.
IDiaEnumFrameData::Clone	Создает перечислитель, содержащий то же состояние перечисления, что и текущий перечислитель.
IDiaEnumFrameData::frameByRVA	Возвращает кадр по относительному виртуальному адресу (RVA).
IDiaEnumFrameData::frameByVA	Возвращает кадр по виртуальному адресу (VA).

Замечания

Заметки для вызывающих абонентов

Получите этот интерфейс из метода IDiaSession::getEnumTables . Этот вариант подробно представлен в примере.

Пример

В этом примере показано, как получить ( GetEnumFrameData функцию) и использовать ( ShowFrameData функцию) IDiaEnumFrameData интерфейса. Пример функции см. в интерфейсе PrintFrameData IDiaFrameData.


      IDiaEnumFrameData* GetEnumFrameData(IDiaSession *pSession)
{
    IDiaEnumFrameData* pUnknown    = NULL;
    REFIID             iid         = __uuidof(IDiaEnumFrameData);
    IDiaEnumTables*    pEnumTables = NULL;
    IDiaTable*         pTable      = NULL;
    ULONG              celt        = 0;

    if (pSession->getEnumTables(&pEnumTables) != S_OK)
    {
        wprintf(L"ERROR - GetTable() getEnumTables\n");
        return NULL;
    }
    while (pEnumTables->Next(1, &pTable, &celt) == S_OK && celt == 1)
    {
        // There is only one table that matches the given iid
        HRESULT hr = pTable->QueryInterface(iid, (void**)&pUnknown);
        pTable->Release();
        if (hr == S_OK)
        {
            break;
        }
    }
    pEnumTables->Release();
    return pUnknown;
}

void ShowFrameData(IDiaSession *pSession)
{
    IDiaEnumFrameData* pEnumFrameData = GetEnumFrameData(pSession);;

    if (pEnumFrameData != NULL)
    {
        IDiaFrameData* pFrameData;
        ULONG celt = 0;

        while(pEnumFrameData->Next(1, &pFrameData, &celt) == S_OK &&
              celt == 1)
        {
            PrintFrameData(pFrameData);
            pFrameData->Release();
        }
        pEnumFrameData->Release();
    }
}

Requirements

Заголовок: Dia2.h

Библиотека: diaguids.lib

DLL: msdia80.dll

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