呼び出し規約、パラメーター、および戻り値の型
ヘルパー ルーチンのプロトタイプは次のとおりです。
FARPROC WINAPI __delayLoadHelper2(
PCImgDelayDescr pidd,
FARPROC * ppfnIATEntry
);
それぞれの文字について以下に説明します。
pidd
さまざまなインポート関連データのオフセット、バインディング情報のタイムスタンプ、および記述子の内容に関するさらに詳しい情報を示す属性が格納される ImgDelayDescr (delayimp.h を参照) への const ポインター。現時点で、属性は dlattrRva の 1 つだけです。dlattrRva は、記述子内のアドレスが、仮想アドレスではなく相対仮想アドレスであることを示します。PCImgDelayDescr 構造体の定義については、「構造体と定数の定義」を参照してください。
ppfnIATEntry
インポートされた関数のアドレスで更新される遅延読み込みインポート アドレス テーブル (IAT: Import Address Table) のスロットへのポインター。ヘルパー ルーチンは、この位置に返す値を格納する必要があります。
戻り値
成功すると、インポートされた関数のアドレスが返されます。
失敗すると、例外が発生し、0 が返されます。発生する可能性のある例外は、以下の 3 種類です。
無効なパラメーター。この例外は、pidd の属性が正しく指定されていない場合に発生します。
指定された DLL での LoadLibrary の失敗。
GetProcAddress のエラー。
これらの例外の処理は、開発者が行います。
解説
ヘルパー関数の呼び出し規約は __stdcall です。戻り値の型は限定されていないので、FARPROC を使用します。この関数には C リンケージがあります。
独自のヘルパー ルーチンを通知フックとして使用しない場合は、関数ポインターの位置に遅延読み込みヘルパーの戻り値を格納する必要があります。この場合は、この関数ポインターの検索をコードで行います。リンカーが生成するサンク コードは、この戻り値をインポートの実際のターゲットと見なし、その位置に直接ジャンプします。
サンプル
簡単なフック関数の実装方法について、次に例を示します。
FARPROC WINAPI delayHook(unsigned dliNotify, PDelayLoadInfo pdli)
{
switch (dliNotify) {
case dliStartProcessing :
// If you want to return control to the helper, return 0.
// Otherwise, return a pointer to a FARPROC helper function
// that will be used instead, thereby bypassing the rest
// of the helper.
break;
case dliNotePreLoadLibrary :
// If you want to return control to the helper, return 0.
// Otherwise, return your own HMODULE to be used by the
// helper instead of having it call LoadLibrary itself.
break;
case dliNotePreGetProcAddress :
// If you want to return control to the helper, return 0.
// If you choose you may supply your own FARPROC function
// address and bypass the helper's call to GetProcAddress.
break;
case dliFailLoadLib :
// LoadLibrary failed.
// If you don't want to handle this failure yourself, return 0.
// In this case the helper will raise an exception
// (ERROR_MOD_NOT_FOUND) and exit.
// If you want to handle the failure by loading an alternate
// DLL (for example), then return the HMODULE for
// the alternate DLL. The helper will continue execution with
// this alternate DLL and attempt to find the
// requested entrypoint via GetProcAddress.
break;
case dliFailGetProc :
// GetProcAddress failed.
// If you don't want to handle this failure yourself, return 0.
// In this case the helper will raise an exception
// (ERROR_PROC_NOT_FOUND) and exit.
// If you choose you may handle the failure by returning
// an alternate FARPROC function address.
break;
case dliNoteEndProcessing :
// This notification is called after all processing is done.
// There is no opportunity for modifying the helper's behavior
// at this point except by longjmp()/throw()/RaiseException.
// No return value is processed.
break;
default :
return NULL;
}
return NULL;
}
/*
and then at global scope somewhere
PfnDliHook __pfnDliNotifyHook2 = delayHook;
*/