Método IDebugSymbols3::GetOffsetByNameWide (dbgeng.h)

  • Artículo

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

Sintaxis

HRESULT GetOffsetByNameWide(
  [in]  PCWSTR   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 se califica 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.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)

Consulte también

GetNameByOffset

IDebugSymbols3