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

Artigo
02/26/2024

O método GetOffsetByName retorna o local de um símbolo identificado pelo nome.

Sintaxe

HRESULT GetOffsetByName(
  [in]  PCSTR    Symbol,
  [out] PULONG64 Offset
);

Parâmetros

[in] Symbol

Especifica o nome do símbolo a ser localizado. O nome pode ser qualificado por um nome de módulo (por exemplo, mymodule!main).

[out] Offset

Recebe o local no espaço de endereço de memória do destino da base da alocação de memória do símbolo.

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 nome Símbolo não era exclusivo e vários símbolos com esse nome foram encontrados. Um desses símbolos foi arbitrariamente escolhido e retornado.
E_FAIL	Nenhum símbolo foi encontrado com o nome especificado.

Comentários

Se o nome Símbolo não for exclusivo e GetOffsetByName encontrar vários símbolos com esse nome, a ambiguidade será resolvida arbitrariamente. Nesse caso, o valor S_FALSE será retornado. StartSymbolMatch pode ser usado para iniciar uma pesquisa para determinar qual é o resultado desejado.

GetNameByOffset não dá suporte à correspondência de padrões (por exemplo, curingas). Para localizar um símbolo usando a correspondência de padrões, use StartSymbolMatch.

Se o nome do módulo do símbolo for conhecido, é melhor qualificar o nome do símbolo com o nome do módulo. Caso contrário, o mecanismo pesquisará os símbolos para todos os módulos até encontrar uma correspondência; isso pode levar muito tempo se precisar carregar os arquivos de símbolo para muitos módulos. Se o nome do símbolo for qualificado com um nome de módulo, o mecanismo pesquisa apenas os símbolos desse módulo.

Para obter mais informações sobre símbolos e nomes de símbolos, consulte Símbolos.