Tipo de retorno, parâmetros e convenções de chamada
Protótipo da rotina auxiliar é:
FARPROC WINAPI __delayLoadHelper2(
PCImgDelayDescr pidd,
FARPROC * ppfnIATEntry
);
Onde:
pidd
A const o ponteiro para um ImgDelayDescr que contém os deslocamentos de vários dados relacionados à importação, um carimbo de hora para informações de vinculação e um conjunto de atributos que fornecem informações adicionais sobre o conteúdo do descritor (consulte delayimp.h). Atualmente, há apenas um atributo, dlattrRva, que indica que os endereços no descritor de endereços virtuais relativos (ao contrário de endereços virtuais).Consulte estrutura and Constant Definitions para a definição da estrutura PCImgDelayDescr.
ppfnIATEntry
Um ponteiro para o slot de carregamento de atraso importar tabela de endereços (IAT) para ser atualizado com o endereço da função importado. A rotina auxiliar precisa armazenar o mesmo valor que irá devolver para este local.
Valores de retorno esperados
Se a função for bem-sucedida, ela retorna o endereço da função importado.
Se a função falhar, ele gerará uma exceção e retorna 0. Três tipos de exceções podem ser disparados:
Parâmetro inválido, o que acontece se os atributos na pidd não estão especificados corretamente.
LoadLibrary falha na DLL especificada.
Falha de GetProcAddress.
É sua responsabilidade de manipular essas exceções.
Comentários
É a convenção de chamada para a função auxiliar __stdcall. O tipo de valor de retorno não é relevante, FARPROC é usado. Esta função tem a ligação C.
O valor de retorno da auxiliar de carregamento de atraso precisa ser armazenado no local de ponteiro passado em função, a menos que você deseja que sua rotina auxiliar a ser usado como um gancho de notificação. Nesse caso, seu código é responsável por localizar o ponteiro de função apropriada para retornar. O código de conversão que o vinculador gera, em seguida, obtém o valor de retorno como o destino real da importação e vai diretamente para ele.
Exemplo
O código a seguir mostra como implementar uma função de gancho simples.
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;
*/