Método IDebugSymbols3::GetOffsetByNameWide (dbgeng.h)
O método GetOffsetByNameWide retorna o local de um símbolo identificado pelo nome.
Sintaxe
HRESULT GetOffsetByNameWide(
[in] PCWSTR 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 |
|---|---|
|
O método foi bem-sucedido. |
|
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. |
|
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dbgeng.h (inclua Dbgeng.h) |