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

Artículo
02/23/2024

El método GetOffsetByName devuelve la ubicación de un símbolo identificado por nombre.

Sintaxis

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

Parámetros

[in] Symbol

Especifica el nombre del símbolo que se va a buscar. El nombre puede calificarse por un nombre de módulo (por ejemplo, mymodule!main).

[out] Offset

Recibe la ubicación en el espacio de direcciones de memoria del destino de la base de la asignación de memoria del símbolo.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el nombre Symbol no era único y se encontraron varios símbolos con ese nombre. Uno de estos símbolos fue elegido arbitrariamente y devuelto.
E_FAIL	No se encontró ningún símbolo con el nombre especificado.

Comentarios

Si el nombre Symbol no es único y GetOffsetByName busca varios símbolos con ese nombre, la ambigüedad se resolverá arbitrariamente. En este caso, se devolverá el valor S_FALSE. StartSymbolMatch se puede usar para iniciar una búsqueda para determinar cuál es el resultado deseado.

GetNameByOffset no admite la coincidencia de patrones (por ejemplo, caracteres comodín). Para buscar un símbolo mediante la coincidencia de patrones, use StartSymbolMatch.

Si se conoce el nombre del módulo para el símbolo, es mejor calificar el nombre del símbolo con el nombre del módulo. De lo contrario, el motor buscará los símbolos de todos los módulos hasta que encuentre una coincidencia; Esto puede tardar mucho tiempo si tiene que cargar los archivos de símbolos para una gran cantidad de módulos. Si el nombre del símbolo está calificado con un nombre de módulo, el motor solo busca los símbolos de ese módulo.

Para obtener más información sobre los símbolos y los nombres de símbolos, vea Símbolos.