Compartir a través de

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

  • Artículo

El motor llama al método de devolución de llamada UnloadModule cuando se produce un evento de depuración de descarga de módulos en el destino.

Sintaxis

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

Parámetros

[in, optional] ImageBaseName

Especifica el nombre del archivo de imagen del módulo, que puede incluir la ruta de acceso. Si esta información no está disponible, ImageBaseName será NULL.

[in] BaseOffset

Especifica la dirección base del módulo en el espacio de direcciones de memoria del destino. Si esta información no está disponible, BaseOffset será NULL.

Valor devuelto

Este método devuelve un valor de DEBUG_STATUS_XXX , que indica cómo debe continuar la ejecución del destino después de que el motor procese este evento. Para obtener más información sobre cómo trata el motor este valor, consulte Supervisión de eventos.

Comentarios

El motor solo llama a este método si la marca DEBUG_EVENT_UNLOAD_MODULE está establecida en la máscara devuelta por IDebugEventCallbacks::GetInterestMask.

Después de llamar a este método, el motor llamará a IDebugEventCallbacks::ChangeSymbolState, con el parámetro Flags que contiene la marca de bits DEBUG_CSS_UNLOADS.

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)