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

  • Artículo

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

Sintaxis

HRESULT GetNameByOffsetWide(
  [in]            ULONG64  Offset,
  [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 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.

Comentarios

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 (include Dbgeng.h)

Consulte también

GetNearNameByOffset

GetOffsetByName

IDebugSymbols3