Método IDebugSymbols3::GetOffsetByNameWide (dbgeng.h)
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 |
---|---|
|
Método realizado correctamente. |
|
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. |
|
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) |