Compartilhar via

Método IDebugEventCallbacks::UnloadModule (dbgeng.h)

  • Artigo

O método de retorno de chamada UnloadModule é chamado pelo mecanismo quando ocorre um evento de depuração de descarregamento de módulo no destino.

Sintaxe

HRESULT UnloadModule(
  [in, optional] PCSTR   ImageBaseName,
  [in]           ULONG64 BaseOffset
);

Parâmetros

[in, optional] ImageBaseName

Especifica o nome do arquivo de imagem do módulo, que pode incluir o caminho. Se essas informações não estiverem disponíveis, ImageBaseName será NULL.

[in] BaseOffset

Especifica o endereço base do módulo no espaço de endereço de memória do destino. Se essas informações não estiverem disponíveis, BaseOffset será NULL.

Retornar valor

Esse método retorna um valor DEBUG_STATUS_XXX , que indica como a execução do destino deve continuar após o mecanismo processar esse evento. Para obter detalhes sobre como o mecanismo trata esse valor, consulte Eventos de monitoramento.

Comentários

Esse método só será chamado pelo mecanismo se o sinalizador DEBUG_EVENT_UNLOAD_MODULE for definido na máscara retornada por IDebugEventCallbacks::GetInterestMask.

Depois de chamar esse método, o mecanismo chamará IDebugEventCallbacks::ChangeSymbolState, com o parâmetro Flags contendo o sinalizador de bit DEBUG_CSS_UNLOADS.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de monitoramento.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)