次の方法で共有

IDiaDataSource::loadAndValidateDataFromPdb

  • [アーティクル]

プログラム データベース (.pdb) ファイルを開いて、指定されたシグネチャ情報と一致することを確認し、.pdb ファイルをデバッグ データ ソースとして準備します。

構文

HRESULT loadAndValidateDataFromPdb ( 
   LPCOLESTR pdbPath,
   GUID*     pcsig70,
   DWORD     sig,
   DWORD     age
);

パラメーター

pdbPath

[入力] .pdb ファイルへのパス。

pcsig70

[in].pdb ファイル署名に対して検証するグローバル一意識別子 (GUID) 署名。 GUID シグネチャがあるのは、Visual C++ 以降の .pdb ファイルだけです。

sig

[入力] .pdb ファイルのシグネチャと照合する 32 ビット シグネチャ。

age

[入力] 確認する経過期間値。 年齢は必ずしも既知の時間値に対応しているわけではありません。.pdb ファイルが対応する.exe ファイルと同期していないかどうかを判断するために使用されます。

戻り値

成功した場合は、S_OK を返します。それ以外の場合は、エラー コードを返します。 次の表に、このメソッドで返される可能性のある戻り値を示します。

値 説明
E_PDB_NOT_FOUND ファイルを開くことができなかったか、ファイルの形式が無効です。
E_PDB_FORMAT 古い形式のファイルにアクセスしようとしました。
E_PDB_INVALID_SIG シグネチャが一致しません。
E_PDB_INVALID_AGE 経過期間が一致しません。
E_INVALIDARG 無効なパラメーター。
E_UNEXPECTED データ ソースは既に準備されています。

解説

.pdb ファイルには、シグネチャと経過期間の両方の値が含まれています。 これらの値は、.pdb ファイルに一致する .exe または .dll ファイルにレプリケートされます。 このメソッドは、データ ソースを準備する前に、指定された .pdb ファイルのシグネチャと経過期間が指定された値と一致することを確認します。

検証せずに .pdb ファイルを読み込むには、IDiaDataSource::loadDataFromPdb メソッドを使用します。

(コールバック メカニズムを介して) データ読み込みプロセスへのアクセスを得るには、IDiaDataSource::loadDataForExe メソッドを使用します。

.pdb ファイルをメモリから直接読み込むには、IDiaDataSource::loadDataFromIStream メソッドを使用します。

例

IDiaDataSource* pSource;  // Previously created data source.
DEFINE_GUID(expectedGUIDSignature,0x1234,0x5678,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08);
DWORD expectedFileSignature = 0x12345678;
DWORD expectedAge           = 128;

HRESULT hr;
hr = pSource->loadAndValidateDataFromPdb( L"yprog.pdb",
                                          &expectedGUIDSignature,
                                          expectedFileSignature,
                                          expectedAge);
if (FAILED(hr))
{
    // Report an error
}

関連項目