通过

IDebugSymbols：：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

接收目标虚拟地址空间中符号的位置。 如果 偏移量NULL，则不会返回此信息。

返回值

此方法还可以返回其他错误值。 有关详细信息，请参阅 返回值。

返回代码 描述
S_OK
 该方法成功。
S_FALSE
 缓冲区的大小太小，无法指定符号的名称，或者 缓冲区NULL。
E_NOINTERFACE
 找不到与模式匹配的符号。

言论

必须先通过 StartSymbolMatch初始化搜索。 找到所有所需符号后，可以使用 EndSymbolMatch 释放引擎保留的资源进行搜索。

有关符号的详细信息，请参阅 符号。

要求

要求 价值
目标平台 桌面
标头 dbgeng.h （包括 Dbgeng.h）

另请参阅

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch