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

Artigo
02/26/2024

O método AddSyntheticSymbol adiciona um símbolo sintético a um módulo no processo atual.

Sintaxe

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 o local no espaço de endereço virtual do processo do símbolo sintético.

[in] Size

Especifica o tamanho em bytes do símbolo sintético.

[in] Name

Especifica o nome do símbolo sintético.

[in] Flags

Defina como DEBUG_ADDSYNTHSYM_DEFAULT.

[out, optional] Id

Recebe a estrutura DEBUG_MODULE_AND_ID que identifica o símbolo sintético. Se Id for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

O local do símbolo sintético não deve ser o mesmo que o local de outro símbolo.

Se o módulo que contém um símbolo sintético for recarregado, por exemplo, chamando Recarregar com o parâmetro Module definido como o nome do módulo, o símbolo sintético será descartado.

Para obter mais informações sobre símbolos sintéticos, consulte Símbolos sintéticos.