IDiaDataSource
Initiates access to a source of debugging symbols.
Syntax
IDiaDataSource : IUnknown
Methods in Vtable Order
The following table shows the methods of IDiaDataSource.
| Method | Description |
|---|---|
IDiaDataSource::get_lastError |
Retrieves the file name for the last load error. |
IDiaDataSource::loadDataFromPdb |
Opens and prepares a program database (.pdb) file as a debug data source. |
IDiaDataSource::loadAndValidateDataFromPdb |
Opens and verifies that the program database (.pdb) file matches the signature information provided; prepares the .pdb file as a debug data source. |
IDiaDataSource::loadDataForExe |
Opens and prepares the debug data associated with the .exe/.dll file. |
IDiaDataSource::loadDataFromIStream |
Prepares the debug data stored in a program database (.pdb) file accessed through an in-memory data stream. |
IDiaDataSource::openSession |
Opens a session for querying symbols. |
IDiaDataSource::loadDataFromCodeViewInfo |
Opens and prepares the debug data associated with the provided CodeView information. |
IDiaDataSource::loadDataFromMiscInfo |
Opens and prepares the debug data associated with the provided debug information. |
Remarks
A call to one of the load methods of the IDiaDataSource 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_IDiaDataSource. The example shows how this interface is obtained.
Example
IDiaDataSource* pSource;
HRESULT hr = CoCreateInstance(CLSID_DiaSource,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDiaDataSource,
(void**) &pSource);
if (FAILED(hr))
{
// Report error and exit
}
Requirements
Header: Dia2.h
Library: diaguids.lib
DLL: msdia140.dll