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

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 é símbolos Delta após o símbolo localizado em Offset. 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 manter 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.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)

Confira também

GetNameByOffset

GetOffsetByName

IDebugSymbols3