Função ImageLoad (imagehlp.h)

  • Artigo

Mantém uma lista de DLLs carregadas.

Sintaxe

PLOADED_IMAGE IMAGEAPI ImageLoad(
  [in] PCSTR DllName,
  [in] PCSTR DllPath
);

Parâmetros

[in] DllName

O nome da imagem.

[in] DllPath

O caminho usado para localizar a imagem se o nome fornecido não puder ser encontrado. Se NULL for usado, as regras de caminho de pesquisa definidas na função SearchPath se aplicarão.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um ponteiro para uma estrutura LOADED_IMAGE .

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função ImageLoad é usada para manter uma lista de DLLs carregadas. Se a imagem já tiver sido carregada, o LOADED_IMAGE anterior será retornado. Caso contrário, a nova imagem será adicionada à lista.

A estrutura LOADED_IMAGE deve ser desalocada pela função ImageUnload .

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

ImageUnload

LOADED_IMAGE