IDebugSymbols2：：GetNameByOffset 方法 (dbgeng.h)

發行項
02/23/2024

GetNameByOffset 方法會傳回目標虛擬位址空間中指定位置的符號名稱。

語法

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

參數

[in] Offset

指定要求名稱之符號之目標虛擬位址空間中的位置。位移不需要指定符號的基底位置;它只需要指定符號記憶體配置內的位置。

[out, optional] NameBuffer

接收符號的名稱。名稱是由符號 (所屬的模組限定，例如 mymodule！main) 。如果 NameBuffer 為 NULL，則不會傳回此資訊。

[in] NameBufferSize

指定緩衝區 NameBuffer 的字元大小。此大小包含『\0』終止字元的空間。

[out, optional] NameSize

以符號名稱的字元接收大小。此大小包含『\0』終止字元的空間。如果 NameSize 為 NULL，則不會傳回此資訊。

[out, optional] Displacement

接收 Offset 值與符號基底位置之間的差異。如果位移為 NULL，則不會傳回此資訊。

傳回值

這個方法也可能傳回其他錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	此方法成功。
S_FALSE	此方法成功。不過，緩衝區不夠大，無法保存符號的名稱，因此已截斷。
E_FAIL	在指定的位置找不到符號。