Método IDebugSymbols3::AddSyntheticModule (dbgeng.h)

Artículo
02/23/2024

El método AddSyntheticModule agrega un módulo sintético a la lista de módulos que mantiene el depurador para el proceso actual.

Sintaxis

HRESULT AddSyntheticModule(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCSTR   ImagePath,
  [in] PCSTR   ModuleName,
  [in] ULONG   Flags
);

Parámetros

[in] Base

Especifica la ubicación en el espacio de direcciones virtuales del proceso de la base del módulo sintético.

[in] Size

Especifica el tamaño en bytes del módulo sintético.

[in] ImagePath

Especifica el nombre de la imagen del módulo sintético. Este es el nombre que se devolverá como el nombre del archivo ejecutable para el módulo sintético. La ruta de acceso completa debe incluirse si se conoce.

[in] ModuleName

Especifica el nombre del módulo para el módulo sintético.

[in] Flags

Establézcalo en DEBUG_ADDSYNTHMOD_DEFAULT.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Comentarios

La región de memoria del módulo sintético, descrita por los parámetros Base y Size , no debe superponerse a la región de memoria de ningún otro módulo.

Si se vuelven a cargar todos los módulos, por ejemplo, llamando a Recarga con el parámetro Module establecido en una cadena vacía, se descartarán todos los módulos sintéticos.

Para obtener más información sobre los módulos sintéticos, vea Módulos sintéticos.