Método IDebugSymbols::GetNameByOffset (dbgeng.h)

Artigo
02/26/2024

O método GetNameByOffset retorna o nome do símbolo no local especificado no espaço de endereço virtual do destino.

Sintaxe

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [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 símbolo de destino cujo nome é solicitado. O deslocamento não precisa especificar o local base do símbolo; ele só precisa especificar um local dentro da alocação de memória do símbolo.

[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 base do símbolo. 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, portanto, ele foi truncado.
E_FAIL	Nenhum símbolo foi encontrado no local especificado.