Compartir a través de


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

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.

Requisitos

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

Consulte también

AddSyntheticModule

IDebugSymbols3

RemoveSyntheticSymbol