IDebugSymbols3：：GetNearNameByOffset 方法 (dbgeng.h)

發行項
02/25/2024

GetNearNameByOffset 方法會傳回位於指定位置附近符號的名稱。

語法

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

參數

[in] Offset

指定目標虛擬位址空間中決定所需符號的位置。

[in] Delta

指定所需符號與位於 Offset 的符號之間的關聯性。如果為正數，引擎會傳回位於 Offset 符號之後差異符號的符號。如果為負數，引擎會傳回位於 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_NOINTERFACE	找不到符合 Offset 和 Delta 規格的符號。