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

Artigo
02/06/2025

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

Sintaxe

HRESULT AddSyntheticSymbolWide(
  [in]            ULONG64              Offset,
  [in]            ULONG                Size,
  [in]            PCWSTR               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

Definido 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.

Valor de retorno

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 de Valores Retornados para obter mais detalhes.

Observações

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 módulo parâmetro 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.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

AddSyntheticModule

IDebugSymbols3

RemoveSyntheticSymbol

Compartilhar via