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

接收符号的名称。 如果 BufferNULL,则下次使用相同的句柄) (调用其中一种方法时,将再次返回相同的符号;这可用于确定符号名称的大小。

[in] BufferSize

指定缓冲区的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。

[out, optional] MatchSize

接收符号名称的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。 如果 MatchSizeNULL,则不会返回此信息。

[out, optional] Offset

接收符号的目标虚拟地址空间中的位置。 如果 OffsetNULL,则不会返回此信息。

返回值

此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值

返回代码 说明
S_OK
方法成功。
S_FALSE
缓冲区的大小对于符号名称而言太小,或者 缓冲区NULL
E_NOINTERFACE
找不到与模式匹配的更多符号。

注解

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

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

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

EndSymbolMatch

IDebugSymbols3

StartSymbolMatch