IDiaSectionContrib

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

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_code16bit

Retrieves a flag that indicates whether the section contains 16-bit 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.

IDiaLineNumber::get_compilandId

Retrieves the compiland identifier for the section.

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: msdia80.dll

See Also

Reference

IDiaEnumSectionContribs

IDiaEnumSectionContribs::Item

IDiaEnumSectionContribs::Next

Other Resources

Interfaces (Debug Interface Access SDK)

Glossary