IDiaDataSource::loadDataFromPdb

Opens and prepares a program database (.pdb) file as a debug data source.

Syntax

HRESULT loadDataFromPdb (
   LPCOLESTR pdbPath
);

Parameters

pdbPath

[in] The path to the .pdb file.

Return Value

If successful, returns S_OK; otherwise, returns an error code. The following table shows the possible return values for this method.

Value Description
E_PDB_NOT_FOUND Failed to open the file, or determined that the file has an invalid format.
E_PDB_FORMAT Attempted to access a file with an incompatible or unsupported format.
E_INVALIDARG Invalid parameter.
E_UNEXPECTED Data source has already been prepared.

Remarks

This method loads the debug data directly from a .pdb file.

To load a .pdb file with prefetching, use the IDiaDataSourceEx::loadDataFromPdbEx method.

To validate the .pdb file against specific criteria, use the IDiaDataSource::loadAndValidateDataFromPdb method.

To gain access to the data load process (through a callback mechanism), use the IDiaDataSource::loadDataForExe method.

To load a .pdb file directly from memory, use the IDiaDataSource::loadDataFromIStream method.

To validate a .pdb file without loading it, use the IDiaDataSourceEx::ValidatePdb method.

Example

HRESULT hr = pSource->loadDataFromPdb( L"myprog.pdb" );
if (FAILED(hr))
{
    // report error
}

See also