Método IDebugSymbols3::GetNearNameByOffsetWide (dbgeng.h)
El método GetNearNameByOffsetWide devuelve el nombre de un símbolo que se encuentra cerca de la ubicación especificada.
Sintaxis
HRESULT GetNearNameByOffsetWide(
[in] ULONG64 Offset,
[in] LONG Delta,
[out, optional] PWSTR NameBuffer,
[in] ULONG NameBufferSize,
[out, optional] PULONG NameSize,
[out, optional] PULONG64 Displacement
);
Parámetros
[in] Offset
Especifica la ubicación en el espacio de direcciones virtuales del destino del símbolo desde el que se determina el símbolo deseado.
[in] Delta
Especifica la relación entre el símbolo deseado y el símbolo ubicado en Offset. Si es positivo, el motor devolverá el símbolo que se símbolos delta después del símbolo ubicado en Offset. Si es negativo, el motor devolverá el símbolo que se símbolos delta antes del símbolo ubicado en Offset.
[out, optional] NameBuffer
Recibe el nombre del símbolo. El nombre está calificado por el módulo al que pertenece el símbolo (por ejemplo, mymodule!main). Si NameBuffer es null, no se devuelve esta información.
[in] NameBufferSize
Especifica el tamaño en caracteres del búfer NameBuffer. Este tamaño incluye el espacio para el carácter de terminación '\0'.
[out, optional] NameSize
Recibe el tamaño en caracteres del nombre del símbolo. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si NameSize es null, no se devuelve esta información.
[out, optional] Displacement
Recibe la diferencia entre el valor de desplazamiento y la ubicación del espacio de direcciones de memoria del destino del símbolo. Si de desplazamiento es NULL, no se devuelve esta información.
Valor devuelto
Este método también puede devolver otros valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El método se realizó correctamente. Sin embargo, el búfer no era lo suficientemente grande como para contener el nombre del símbolo para que se truncase. |
|
No se encontró ningún símbolo que coincida con las especificaciones de Offset y Delta. |
Observaciones
Al aumentar o disminuir el valor de Delta, estos métodos se pueden usar para iterar los símbolos del destino a partir de una ubicación determinada.
Si delta es cero, estos métodos se comportan del mismo modo que GetNameByOffset.
Para obtener más información sobre los símbolos y los nombres de símbolos, vea Símbolos.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |