共用方式為

IDebugSymbols2：：GetNextSymbolMatch 方法 （dbgeng.h）

  • 發行項

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

接收符號的名稱。 如果 緩衝區NULL，下次呼叫其中一個方法時，會再次傳回相同的符號（具有相同句柄）：這可用來判斷符號名稱的大小。

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

傳回值

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

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

言論

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

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

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）

另請參閱

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch