IDebugSymbols3：：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	缓冲区的大小对于符号名称而言太小，或者缓冲区为 NULL。
E_NOINTERFACE	找不到与模式匹配的更多符号。