Compartilhar via


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

Confira também

Funções ImageHlp

LOADED_IMAGE

UnMapAndLoad