Partilhar via

IDiaEnumSectionContribs

  • Artigo

Enumera as várias contribuições de seção contidas na fonte de dados.

Syntax

IDiaEnumSectionContribs : IUnknown

Métodos na ordem VTable

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

Método Descrição
IDiaEnumSectionContribs::get__NewEnum Recupera a versão da Interface IEnumVARIANT desse enumerador.
IDiaEnumSectionContribs::get_Count Recupera o número de contribuições de seção.
IDiaEnumSectionContribs::Item Recupera contribuições de seção por meio de um índice.
IDiaEnumSectionContribs::Next Recupera um número especificado de contribuições de seção na sequência de enumeração.
IDiaEnumSectionContribs::Skip Ignora um número especificado de contribuições de seção em uma sequência de enumeração.
IDiaEnumSectionContribs::Reset Redefine uma sequência de enumeração para o início.
IDiaEnumSectionContribs::Clone Cria um enumerador que contém o mesmo estado de enumeração que o enumerador atual.

Comentários

Observação 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 GetEnumSectionContribs) e usar (a função ShowSectionContribs) da interface IDiaEnumSectionContribs. Para obter um exemplo mais completo de como usar contribuições de seção, consulte a interface IDiaSectionContrib.


IDiaEnumSectionContribs* GetEnumSectionContribs(IDiaSession *pSession)
{
    IDiaEnumSectionContribs* pUnknown    = NULL;
    REFIID                   iid         = __uuidof(IDiaEnumSectionContribs);
    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 ShowSectionContribs(IDiaSession *pSession)
{
    IDiaEnumSectionContribs* pEnumSectionContribs;

    pEnumSectionContribs = GetEnumSectionContribs(pSession);
    if (pSectionContrib != NULL)
    {
        IDiaSectionContrib* pSectionContrib;
        ULONG celt = 0;

        while(pEnumSectionContribs->Next(1, &pSectionContrib, &celt) == S_OK &&
              celt == 1)
        {
            PrintSectionContrib(pSectionContrib, pSession);
            pSectionContrib->Release();
        }
        pSectionContrib->Release();
    }
}

Requisitos

Cabeçalho: Dia2.h

Biblioteca: diaguids.lib

DLL: msdia80.dll

Confira também