IDiaDataSourceEx::loadDataForExeEx
打开并准备与 .exe/.dll 文件关联的调试数据，并预提取可选记录。
语法
HRESULT loadDataForExeEx (
LPCOLESTR executable,
LPCOLESTR searchPath,
IUnknown* pCallback,
BOOL fPdbPrefetching
);
参数
executable
[in] .exe 或 .dll 文件的路径。
searchPath
[in] 用于搜索调试数据的备用路径。 多个路径应以分号分隔。 路径可能包含尾随 \。
pCallback
[in] IUnknown 支持调试回调接口的对象接口，例如 IDiaLoadCallback、 IDiaLoadCallback2、 IDiaReadExeAtOffsetCallback和/或 IDiaReadExeAtRVACallback 接口。
fPdbPrefetching
[in]如果设置为 TRUE，则相邻的调试记录将预提取到内存中，可能会将许多较小的文件 I/O 操作替换为更少、更大的操作，从而提高总体吞吐量，因为随后访问这些记录，代价是内存使用量可能会增加。 如果设置为 FALSE，则其行为方式与 IDiaDataSource::loadDataForExe 相同。 如果设置为其他值，则行为未指定。
返回值
如果成功，则返回 S_OK；否则，返回错误代码。 下表显示了此方法的一些可能的错误代码。
| 值 | 说明 |
|---|---|
E_PDB_NOT_FOUND |
无法打开文件或该文件的格式无效。 |
E_PDB_FORMAT |
尝试访问采用过时格式的文件。 |
E_PDB_INVALID_SIG |
签名不匹配。 |
E_PDB_INVALID_AGE |
年限不匹配。 |
E_INVALIDARG |
参数无效。 |
E_UNEXPECTED |
数据源已准备好。 |
备注
.exe/.dll 文件的调试头会命名相关的调试数据位置。
如果要从符号服务器加载调试数据， symsrv.dll 必须存在于安装了用户应用程序或 msdia140.dll 的同一目录中，或者它必须存在于系统目录中。
此方法会读取调试头，然后搜索并准备调试数据。 搜索的进度可以选择通过回调进行报告和控制。 例如， IDiaLoadCallback::NotifyDebugDir 当方法查找和处理调试目录时 IDiaDataSourceEx::loadDataForExeEx ，将调用该目录。
IDiaReadExeAtRVACallback当IDiaReadExeAtOffsetCallback无法通过标准文件 I/O 直接访问文件时，客户端应用程序允许客户端应用程序提供从可执行文件读取数据的替代方法。
若要在不验证的情况下加载 .pdb 文件，请使用 IDiaDataSourceEx::loadDataFromPdbEx 该方法。
若要根据特定条件验证 .pdb 文件，请使用 IDiaDataSourceEx::loadAndValidateDataFromPdbEx 该方法。
若要直接从内存中加载 .pdb 文件，请使用 IDiaDataSourceEx::loadDataFromIStreamEx 该方法。
若要验证 .pdb 文件而不加载该文件，请使用 IDiaDataSourceEx::ValidatePdb 该方法。
示例
class MyCallBack: public IDiaLoadCallback
{
...
};
MyCallBack callback;
...
HRESULT hr = pSource->loadDataForExeEx( L"myprog.exe", L".\debug", (IUnknown*)&callback, TRUE);
if (FAILED(hr))
{
// Report error
}