Compartilhar via


IDiaEnumFrameData

Enumera os vários elementos de dados de quadro contidos na fonte de dados.

Sintaxe

IDiaEnumFrameData : IUnknown

Métodos na ordem VTable

A tabela a seguir mostra os métodos de IDiaEnumFrameData.

Método Descrição
IDiaEnumFrameData::get__NewEnum Recupera a versão IEnumVARIANT Interface desse enumerador.
IDiaEnumFrameData::get_Count Recupera o número de elementos de dados de quadro.
IDiaEnumFrameData::Item Recupera um elemento de dados de quadro por meio de um índice.
IDiaEnumFrameData::Next Recupera um número especificado de elementos de dados do quadro na sequência de enumeração.
IDiaEnumFrameData::Skip Ignora um número especificado de elementos de dados de quadro em uma sequência de enumeração.
IDiaEnumFrameData::Reset Redefine uma sequência de enumeração para o início.
IDiaEnumFrameData::Clone Cria um enumerador que contém o mesmo estado de enumeração que o enumerador atual.
IDiaEnumFrameData::frameByRVA Retorna um quadro por RVA (endereço virtual relativo).
IDiaEnumFrameData::frameByVA Retorna um quadro por VA (endereço virtual).

Comentários

Observações para chamadores

Obtenha essa interface a partir do método IDiaSession::getEnumTables. Consulte este exemplo para obter detalhes.

Exemplo

Esse exemplo mostra como obter (a função GetEnumFrameData) e usar (a função ShowFrameData) da interface IDiaEnumFrameData. Consulte a interface IDiaFrameData para obter um exemplo da função PrintFrameData.


      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();
    }
}

Requisitos

Cabeçalho: Dia2.h

Biblioteca: diaguids.lib

DLL: msdia80.dll

Confira também