Tipo de retorno, parâmetros e convenções de chamada
Protótipo da rotina de auxiliar é:
FARPROC WINAPI __delayLoadHelper2(
PCImgDelayDescr pidd,
FARPROC * ppfnIATEntry
);
Onde:
pidd
A const o ponteiro para um ImgDelayDescr (consulte delayimp.h) 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.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 no 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.
Ele é sua responsabilidade para 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, para que FARPROC seja usado.Esta função tem a ligação C.
O valor de retorno da auxiliar carga atraso precisa ser armazenado no local de ponteiro passado em função, a menos 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, utiliza esse 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;
*/