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

Artigo
02/06/2025

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.

Valor de retorno

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

Observações

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
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Partilhar via