IDiaDataSource::loadDataFromCodeViewInfo
打开并准备与 .exe
/.dll
文件关联的调试数据。
语法
HRESULT loadDataFromCodeViewInfo (
LPCOLESTR executable,
LPCOLESTR searchPath,
DWORD cbCvInfo,
BYTE* pbCvInfo,
IUnknown* pCallback
);
参数
可执行文件
[in] .exe
或 .dll
文件的路径。
SearchPath
[in]用于搜索调试数据的备用路径。 多个路径应以分号分隔。 路径可能包含尾随 \
。
cbCvInfo
[in]参数的大小(以字节为单位 pbCvInfo
)。
pbCvInfo
[in]替代的调试标头代码视图信息(替换从可执行文件的IMAGE_DEBUG_DIRECTORY中正常读取的内容)。 仅支持 RSDS 或 NB10 标头。
pCallback
[in]支持 IUnknown
调试回调接口的对象接口,例如 IDiaLoadCallback
,、 IDiaLoadCallback2
、 IDiaReadExeAtOffsetCallback
和/或 “IDiaReadExeAtRVACallback 接口”。
返回值
如果成功,则返回 S_OK
;否则,返回错误代码。 下表显示了此方法的一些可能的错误代码。
值 | 说明 |
---|---|
E_PDB_NOT_FOUND |
无法打开文件或该文件的格式无效。 |
E_PDB_FORMAT |
尝试访问格式不受支持的文件。 |
E_PDB_INVALID_SIG |
签名不匹配。 |
E_PDB_INVALID_AGE |
年限不匹配。 |
E_INVALIDARG |
参数无效。 |
E_UNEXPECTED |
数据源已准备好。 |
注解
代码视图信息( IMAGE_DEBUG_TYPE_CODEVIEW
格式)将关联的调试数据位置命名,并指示要匹配的签名和年龄字段。
如果要从符号服务器加载调试数据, symsrv.dll 必须存在于安装了用户应用程序或 msdia140.dll 的同一目录中,或者它必须存在于系统目录中。
此方法读取提供的调试标头,然后搜索并准备调试数据。 搜索的进度可以选择通过回调进行报告和控制。 例如, IDiaLoadCallback::NotifyDebugDir
当方法查找和处理调试目录时 IDiaDataSource::loadDataForExe
,将调用该目录。
IDiaReadExeAtRVACallback
当IDiaReadExeAtOffsetCallback
无法通过标准文件 I/O 直接访问文件时,客户端应用程序允许客户端应用程序提供从可执行文件读取数据的替代方法。
若要在不验证的情况下加载 .pdb
文件,请使用 IDiaDataSource::loadDataFromPdb
该方法。
若要根据特定条件验证 .pdb 文件,请使用 IDiaDataSource::loadAndValidateDataFromPdb
该方法。
若要直接从内存中加载 .pdb 文件,请使用 IDiaDataSource::loadDataFromIStream
该方法。
若要验证 .pdb 文件而不加载它,请使用 IDiaDataSourceEx::ValidatePdb 方法 。
示例
BYTE pbCodeViewInfo[] = {
...
};
HRESULT hr = pSource->loadDataFromCodeViewInfo( L"myprog.exe", L".\debug", sizeof(pbCodeViewInfo), pbCodeViewInfo, nullptr);
if (FAILED(hr))
{
// Report error
}