IDiaDataSourceEx

Article
08/07/2024

Initiates access to a source of debugging symbols.

Syntax

IDiaDataSourceEx : IDiaDataSource

Methods in Vtable Order

The following table shows the methods of IDiaDataSourceEx.

Method	Description
`IDiaDataSourceEx::loadDataFromPdbEx`	Opens and prepares a program database (.pdb) file as a debug data source.
`IDiaDataSourceEx::loadAndValidateDataFromPdbEx`	Opens and verifies that the program database (.pdb) file matches the signature information provided; prepares the .pdb file as a debug data source.
`IDiaDataSourceEx::loadDataForExeEx`	Opens and prepares the debug data associated with the .exe/.dll file.
`IDiaDataSourceEx::loadDataFromIStreamEx`	Prepares the debug data stored in a program database (.pdb) file accessed through an in-memory data stream.
`IDiaDataSourceEx::getStreamSize`	Reads the size of a named stream within this program database (.pdb) file.
`IDiaDataSourceEx::getStreamRawData`	Reads the data of a named stream within this program database (.pdb) file.
`IDiaDataSourceEx::setPfnMiniPDBErrorCallback2`	Set a callback function pointer for receiving error notifications relating to fastlink PDBs.
`IDiaDataSourceEx::ValidatePdb`	Only verifies that the program database (.pdb) file matches the signature information provided.

Remarks

A call to one of the load methods of the IDiaDataSourceEx interface opens the symbol source. A successful call to the IDiaDataSource::openSession method returns an IDiaSession interface that supports querying the data source. If the load method returns a file-related error then the IDiaDataSource::get_lastError method return value contains the file name associated with the error.

Notes for Callers

This interface is obtained by calling the CoCreateInstance function with the class identifier CLSID_DiaSource and the interface ID of IID_IDiaDataSourceEx, or by calling QueryInterface on an existing IDiaDataSource interface pointer. The example shows how this interface is obtained.

Example


      IDiaDataSource* pSource;
HRESULT hr = CoCreateInstance(CLSID_DiaSource,
                              NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IDiaDataSourceEx,
                              (void**) &pSource);
if (FAILED(hr))
{
    // Report error and exit
}

Requirements

Header: Dia2.h

Library: diaguids.lib

DLL: msdia140.dll

Share via