Método IDebugSymbols3::GetNameByOffset (dbgeng.h)
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 destino do símbolo cujo nome é solicitado. de 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 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 de Deslocamento e o local base do símbolo. 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 foi encontrado no local especificado. |
Observações
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) |