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

Artículo
02/26/2024

El método GetNearNameByOffset devuelve el nombre de un símbolo que se encuentra cerca de la ubicación especificada.

Sintaxis

HRESULT GetNearNameByOffset(
  [in]            ULONG64  Offset,
  [in]            LONG     Delta,
  [out, optional] PSTR     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 es símbolos delta después del símbolo ubicado en Offset. Si es negativo, el motor devolverá el símbolo que es 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 Offset y la ubicación en el espacio de direcciones de memoria del destino del símbolo. Si El 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 detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el búfer no era lo suficientemente grande como para contener el nombre del símbolo para que se truncase.
E_NOINTERFACE	No se encontró ningún símbolo que coincida con las especificaciones de Offset y Delta .

Comentarios

Al aumentar o disminuir el valor de Delta, estos métodos se pueden usar para iterar en 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.