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

Artículo
02/23/2024

El método AddSyntheticSymbol agrega un símbolo sintético a un módulo del proceso actual.

Sintaxis

HRESULT AddSyntheticSymbol(
  [in]            ULONG64              Offset,
  [in]            ULONG                Size,
  [in]            PCSTR                Name,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Id
);

Parámetros

[in] Offset

Especifica la ubicación en el espacio de direcciones virtuales del proceso del símbolo sintético.

[in] Size

Especifica el tamaño en bytes del símbolo sintético.

[in] Name

Especifica el nombre del símbolo sintético.

[in] Flags

Establezca en DEBUG_ADDSYNTHSYM_DEFAULT.

[out, optional] Id

Recibe la estructura DEBUG_MODULE_AND_ID que identifica el símbolo sintético. Si Id es NULL, esta información no se devuelve.

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 ubicación del símbolo sintético no debe ser la misma que la ubicación de otro símbolo.

Si el módulo que contiene un símbolo sintético se vuelve a cargar; por ejemplo, llamando a Recarga con el parámetro Module establecido en el nombre del módulo, se descartará el símbolo sintético.

Para obtener más información sobre los símbolos sintéticos, vea Símbolos sintéticos.