Função MapAndLoad (imagehlp.h)
Mapeia uma imagem e pré-carrega dados do arquivo mapeado.
Sintaxe
BOOL IMAGEAPI MapAndLoad(
[in] PCSTR ImageName,
[in] PCSTR DllPath,
[out] PLOADED_IMAGE LoadedImage,
[in] BOOL DotDll,
[in] BOOL ReadOnly
);
Parâmetros
[in] ImageName
O nome do arquivo da imagem (arquivo executável ou DLL) que é carregado.
[in] DllPath
O caminho usado para localizar a imagem se o nome fornecido não puder ser encontrado. Se esse parâmetro for NULL, as regras de caminho de pesquisa definidas usando a função SearchPath serão aplicadas.
[out] LoadedImage
Um ponteiro para uma estrutura LOADED_IMAGE que recebe informações sobre a imagem depois que ela é carregada.
[in] DotDll
A extensão padrão a ser usada se o nome da imagem não contiver uma extensão de nome de arquivo. Se o valor for TRUE, uma extensão de .DLL será usada. Se o valor for FALSE, uma extensão .EXE será usada.
[in] ReadOnly
O modo de acesso. Se esse valor for TRUE, o arquivo será mapeado somente para acesso de leitura. Se o valor for FALSE, o arquivo será mapeado para acesso de leitura e gravação.
Valor retornado
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
A função MapAndLoad mapeia uma imagem e pré-carrega dados do arquivo mapeado. A função correspondente, UnMapAndLoad, deve ser usada para desalocar todos os recursos alocados pela função MapAndLoad .
Todas as funções ImageHlp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imagehlp.h |
| Biblioteca | Imagehlp.lib |
| DLL | Imagehlp.dll |