Opens and prepares the debug data associated with the .exe/.dll file.
[in] Path to the .exe or .dll file.
[in] Alternate path to search for debug data.
[in] An IUnknown interface for an object that supports a debug callback interface, such as the, , the , and/or the interfaces.
If successful, returns S_OK; otherwise, returns an error code. The following table shows some of the possible error codes for this method.
Failed to open the file, or the file has an invalid format.
Attempted to access a file with an obsolete format.
Signature does not match.
Age does not match.
Data source has already been prepared.
The debug header of the .exe/.dll file names the associated debug data location.
This method reads the debug header and then searches for and prepares the debug data. The progress of the search may, optionally, be reported and controlled through callbacks. For example, theis invoked when the IDiaDataSource::loadDataForExe method finds and processes a debug directory.
Theand interfaces allow the client application to provide alternative methods for reading data from the executable file when the file cannot be accessed directly through standard file I/O.
To load a .pdb file without validation, use themethod.
To validate the .pdb file against specific criteria, use themethod.
To load a .pdb file directly from memory, use themethod.