IDiaSectionContrib

Article
07/18/2024

Retrieves data describing a section contribution, that is, a contiguous block of memory contributed to the image by a compiland.

Syntax

IDiaSectionContrib : IUnknown

Methods in Vtable Order

The following table shows the methods of IDiaSectionContrib.

Method	Description
`IDiaSectionContrib::get_compiland`	Retrieves a reference to the compiland symbol that contributed this section.
`IDiaSectionContrib::get_addressSection`	Retrieves the section part of the contribution's address.
`IDiaSectionContrib::get_addressOffset`	Retrieves the offset part of the contribution's address.
`IDiaSectionContrib::get_relativeVirtualAddress`	Retrieves the image relative virtual address (RVA) of the contribution.
`IDiaSectionContrib::get_virtualAddress`	Retrieves the virtual address (VA) of the contribution.
`IDiaSectionContrib::get_length`	Retrieves the number of bytes in a section.
`IDiaSectionContrib::get_notPaged`	Retrieves a flag that indicates whether the section cannot be paged out of memory.
`IDiaSectionContrib::get_nopad`	Retrieves a flag indicating whether the section should not be padded to the next memory boundary.
`IDiaSectionContrib::get_code`	Retrieves a flag that indicates whether the section contains executable code.
`IDiaSectionContrib::get_initializedData`	Retrieves a flag that indicates whether the section contains initialized data.
`IDiaSectionContrib::get_uninitializedData`	Retrieves a flag that indicates whether the section contains uninitialized data.
`IDiaSectionContrib::get_informational`	Retrieves a flag indicating whether a section contains comments or similar information.
`IDiaSectionContrib::get_remove`	Retrieves a flag that indicates whether the section is removed before it is made part of the in-memory image.
`IDiaSectionContrib::get_comdat`	Retrieves a flag that indicates whether the section is a COMDAT record.
`IDiaSectionContrib::get_discardable`	Retrieves a flag that indicates whether the section can be discarded.
`IDiaSectionContrib::get_notCached`	Retrieves a flag that indicates whether the section cannot be cached.
`IDiaSectionContrib::get_share`	Retrieves a flag that indicates whether the section can be shared in memory.
`IDiaSectionContrib::get_execute`	Retrieves a flag that indicates whether the section is executable as code.
`IDiaSectionContrib::get_read`	Retrieves a flag that indicates whether the section can be read.
`IDiaSectionContrib::get_write`	Retrieves a flag that indicates whether the section can be written.
`IDiaSectionContrib::get_dataCrc`	Retrieves the cyclic redundancy check (CRC) of the data in the section.
`IDiaSectionContrib::get_relocationsCrc`	Retrieves the CRC of the relocation information for the section.
`IDiaSectionContrib::get_compilandId`	Retrieves the compiland identifier for the section.
`IDiaSectionContrib::get_code16bit`	Retrieves a flag that indicates whether the section contains 16-bit code.

Remarks

Notes for Callers

This interface is obtained by calling the IDiaEnumSectionContribs::Item and IDiaEnumSectionContribs::Next methods. See the IDiaEnumSectionContribs interface for an example of obtaining the IDiaSectionContrib interface.

Example

This function shows the address of each section along with any associated symbols. See the IDiaEnumSectionContribs interface to see how the IDiaSectionContrib interface is obtained.

void PrintSectionContrib(IDiaSectionContrib* pSecContrib, IDiaSession* pSession)
{
    if (pSecContrib != NULL && pSession != NULL)
    {
        DWORD rva;
        if ( pSecContrib->get_relativeVirtualAddress( &rva ) == S_OK )
        {
            printf( "\taddr: 0x%.8X", rva );
            pSecContrib = NULL;
            CComPtr<IDiaSymbol> pSym;
            if ( psession->findSymbolByRVA( rva, SymTagNull, &pSym ) == S_OK )
            {
                CDiaBSTR name;
                DWORD    tag;
                pSym->get_symTag( &tag );
                pSym->get_name( &name );
                printf( "     symbol: %ws (%ws)\n",
                        name != NULL ? name : L"",
                        szTags[ tag ] );
            }
            else
            {
                printf( "<no symbol found?>\n" );
            }
        }
        else
        {
            DWORD isect;
            DWORD offset;
            pSecContrib->get_addressSection( &isect );
            pSecContrib->get_addressOffset( &offset );
            printf( "\taddr: 0x%.4X:0x%.8X", isect, offset );
            pSecContrib = NULL;
            CComPtr<IDiaSymbol> pSym;
            if ( SUCCEEDED( psession->findSymbolByAddr(
                                              isect,
                                              offset,
                                              SymTagNull,
                                              &pSym )
                          )
               )
            {
                CDiaBSTR name;
                DWORD    tag;
                pSym->get_symTag( &tag );
                pSym->get_name( &name );
                printf( "     symbol: %ws (%ws)\n",
                    name != NULL ? name : L"",
                    szTags[ tag ] );
            }
            else
            {
                printf( "<no symbol found?>\n" );
            }
        }
    }
}

Requirements

Header: Dia2.h

Library: diaguids.lib

DLL: msdia140.dll

Share via