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

Artículo
02/26/2024

El método GetNameByOffset devuelve el nombre del símbolo en la ubicación especificada en el espacio de direcciones virtuales del destino.

Sintaxis

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [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 cuyo nombre se solicita. El desplazamiento no necesita especificar la ubicación base del símbolo; solo necesita especificar una ubicación dentro de la asignación de memoria del símbolo.

[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, esta información no se devuelve.

[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, esta información no se devuelve.

[out, optional] Displacement

Recibe la diferencia entre el valor de Offset y la ubicación base del símbolo. Si El desplazamiento es NULL, esta información no se devuelve.

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, por lo que se truncaba.
E_FAIL	No se encontró ningún símbolo en la ubicación especificada.