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

Artigo
02/06/2025

O método GetNearNameByOffsetWide retorna o nome de um símbolo localizado próximo ao local especificado.

Sintaxe

HRESULT GetNearNameByOffsetWide(
  [in]            ULONG64  Offset,
  [in]            LONG     Delta,
  [out, optional] PWSTR    NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

Parâmetros

[in] Offset

Especifica o local no espaço de endereço virtual do destino do símbolo do qual o símbolo desejado é determinado.

[in] Delta

Especifica a relação entre o símbolo desejado e o símbolo localizado em Deslocamento. Se positivo, o mecanismo retornará o símbolo que está símbolos delta após o símbolo localizado em deslocamento. Se for negativo, o mecanismo retornará o símbolo símbolos delta antes do símbolo localizado em de Deslocamento.

[out, optional] NameBuffer

Recebe o nome do símbolo. O nome é qualificado pelo módulo ao qual o símbolo pertence (por exemplo, mymodule!main). Se namebuffer for NULL, essas informações não serão retornadas.

[in] NameBufferSize

Especifica o tamanho em caracteres do buffer namebuffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] NameSize

Recebe o tamanho em caracteres do nome do símbolo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se NameSize for NULL, essas informações não serão retornadas.

[out, optional] Displacement

Recebe a diferença entre o valor de deslocamento e o local no espaço de endereço de memória do símbolo do destino. Se de Deslocamento for NULL, essas informações não serão retornadas.

Valor de retorno

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, o buffer não era grande o suficiente para conter o nome do símbolo, portanto, ele foi truncado.
E_NOINTERFACE	Nenhum símbolo que corresponda às especificações de offset e Delta foi encontrado.

Observações

Aumentando ou diminuindo o valor de Delta, esses métodos podem ser usados para iterar sobre os símbolos do destino começando em um local específico.

Se Delta for zero, esses métodos se comportarão da mesma maneira que GetNameByOffset.

Para obter mais informações sobre símbolos e nomes de símbolos, consulte Symbols.

Requisitos

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

Consulte também

GetNameByOffset

GetOffsetByName

IDebugSymbols3

Partilhar via