IDiaDataSource::loadDataFromCodeViewInfo
.exe/.dll ファイルに関連付けられているデバッグ データを開いて準備します。
構文
HRESULT loadDataFromCodeViewInfo (
LPCOLESTR executable,
LPCOLESTR searchPath,
DWORD cbCvInfo,
BYTE* pbCvInfo,
IUnknown* pCallback
);
パラメーター
executable
[in] .exe または .dll ファイルへのパス。
searchPath
[in]デバッグ データを検索するための代替パス。 複数のパスはセミコロンで区切る必要があります。 パスには、末尾の \が含まれている場合があります。
cbCvInfo
[in] pbCvInfo パラメーターのサイズ (バイト単位)。
pbCvInfo
[in](実行可能ファイルのIMAGE_DEBUG_DIRECTORYから通常の読み取り値を置き換えるために) 代替のデバッグ ヘッダー コード ビュー情報。 RSDS または NB10 ヘッダーのみがサポートされています。
pCallback
[in]IDiaLoadCallback、IDiaLoadCallback2、IDiaReadExeAtOffsetCallback、'IDiaReadExeAtRVACallback インターフェイスなどのデバッグ コールバック インターフェイスをサポートするオブジェクトのIUnknown インターフェイス。
戻り値
成功した場合は、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 メソッドがデバッグ ディレクトリを検索して処理するときに呼び出されます。
IDiaReadExeAtOffsetCallbackインターフェイスとIDiaReadExeAtRVACallback インターフェイスを使用すると、クライアント アプリケーションは、標準ファイル 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
}