共用方式為

IDebugSymbols3：：GetNextSymbolMatchWide 方法 (dbgeng.h)

  • 發行項

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

語法

HRESULT GetNextSymbolMatchWide(
  [in]            ULONG64  Handle,
  [out, optional] PWSTR    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
 找不到符合模式的符號。

備註

搜尋必須先由 StartSymbolMatch 初始化。 找到所有所需的符號之後， EndSymbolMatch 可用來釋放引擎為搜尋保留的資源。

如需符號的詳細資訊，請參閱 符號。

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

EndSymbolMatch

IDebugSymbols3

StartSymbolMatch