Método IDebugSymbols2::GetNearNameByOffset (dbgeng.h)

Artigo
02/23/2024

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

Sintaxe

HRESULT GetNearNameByOffset(
  [in]            ULONG64  Offset,
  [in]            LONG     Delta,
  [out, optional] PSTR     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 Offset. Se positivo, o mecanismo retornará o símbolo que é símbolos Delta após o símbolo localizado em Deslocamento. Se for negativo, o mecanismo retornará o símbolo que é símbolos Delta antes do símbolo localizado em 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 nameBuffer do buffer. 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 Offset e o local no espaço de endereço de memória do símbolo do destino. Se o Deslocamento for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte 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 para que ele fosse truncado.
E_NOINTERFACE	Nenhum símbolo que corresponda às especificações de Offset e Delta foi encontrado.

Comentários

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 Símbolos.