Método IDebugSymbols2::GetNearNameByOffset (dbgeng.h)
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 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 |
|---|---|
|
O método foi bem-sucedido. |
|
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. |
|
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) |