IDebugSymbols2：：GetNextSymbolMatch 方法 (dbgeng.h)

發行項
02/23/2024

GetNextSymbolMatch 方法會傳回在符號搜尋中找到的下一個符號。

語法

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

參數

[in] Handle

指定初始化搜尋時 StartSymbolMatch 所傳回的句柄。

[out, optional] Buffer

接收符號的名稱。如果 Buffer 為 NULL，下次呼叫其中一個方法時，會再次傳回相同的符號， (相同的句柄) ;這可用來判斷符號名稱的大小。

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

接收符號之目標虛擬位址空間中的位置。如果 Offset 為 NULL，則不會傳回此資訊。

傳回值

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

傳回碼	描述
S_OK	此方法成功。
S_FALSE	緩衝區的大小對於符號名稱而言太小，或 Buffer 是 NULL。
E_NOINTERFACE	找不到符合模式的符號。