Função SymLoadModuleExW (dbghelp.h)
Carrega a tabela de símbolos para o módulo especificado.
Sintaxe
DWORD64 IMAGEAPI SymLoadModuleExW(
[in] HANDLE hProcess,
[in] HANDLE hFile,
[in] PCWSTR ImageName,
[in] PCWSTR ModuleName,
[in] DWORD64 BaseOfDll,
[in] DWORD DllSize,
[in] PMODLOAD_DATA Data,
[in] DWORD Flags
);
Parâmetros
[in] hProcess
Um identificador para o processo que foi passado originalmente para a função SymInitialize.
[in] hFile
Um identificador para o arquivo para a imagem executável. Esse argumento é usado principalmente por depuradores, em que o depurador passa o identificador de arquivo obtido de um evento de depuração. Um valor de NULL indica que hFile não é usado.
[in] ImageName
O nome da imagem executável. Esse nome pode conter um caminho parcial, um caminho completo ou nenhum caminho. Se o arquivo não puder ser localizado pelo nome fornecido, o caminho de pesquisa de símbolos será usado.
[in] ModuleName
Um nome de atalho para o módulo. Se o valor do ponteiro for NULL, a biblioteca criará um nome usando o nome base do arquivo de símbolo.
[in] BaseOfDll
O endereço de carga do módulo. Se o valor for zero, a biblioteca obterá o endereço de carga do arquivo de símbolo. O endereço de carga contido no arquivo de símbolo não é necessariamente o endereço de carga real. Os depuradores e outros aplicativos que têm um endereço de carga real devem usar o endereço de carga real ao chamar essa função.
Se a imagem for um arquivo .pdb, esse parâmetro não poderá ser zero.
[in] DllSize
O tamanho do módulo, em bytes. Se o valor for zero, a biblioteca obterá o tamanho do arquivo de símbolo. O tamanho contido no arquivo de símbolo não é necessariamente o tamanho real. Os depuradores e outros aplicativos com um tamanho real devem usar o tamanho real ao chamar essa função.
Se a imagem for um arquivo .pdb, esse parâmetro não poderá ser zero.
[in] Data
Um ponteiro para uma estrutura de MODLOAD_DATA que representa cabeçalhos diferentes do cabeçalho PE padrão. Esse parâmetro é opcional e pode ser NULL.
[in] Flags
Esse parâmetro pode ser zero ou um ou mais dos valores a seguir. Se esse parâmetro for zero, a função carregará os módulos e os símbolos do módulo.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será o endereço base do módulo carregado.
Se a função falhar, o valor retornado será zero. Para recuperar informações de erro estendidas, chame GetLastError.
Se o módulo já estiver carregado, o valor retornado será zero e GetLastError retornará ERROR_SUCCESS.
Observações
O manipulador de símbolos cria uma entrada para o módulo e, se a opção de carregamento de símbolo adiada estiver desativada, será feita uma tentativa de carregar os símbolos. Se o carregamento de símbolo adiado estiver habilitado, o módulo será marcado como adiado e os símbolos não serão carregados até que uma referência seja feita a um símbolo no módulo. Portanto, você sempre deve chamar a função SymGetModuleInfo64 depois de chamar SymLoadModuleEx.
Para descarregar a tabela de símbolos, use a função SymUnloadModule64.
Todas as funções DbgHelp, como esta, são threaded simples. 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.
Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.
Exemplos
Para obter um exemplo, consulte Carregando um módulo de símbolo.
Nota
O cabeçalho dbghelp.h define SymLoadModuleEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino |
Windows |
| cabeçalho | dbghelp.h |
| biblioteca | Dbghelp.lib |
| de DLL |
Dbghelp.dll |
| redistribuível | DbgHelp.dll 6.0 ou posterior |