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,则不会返回此信息。
返回值
此方法也可能返回其他错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
缓冲区的大小对于符号名称而言太小,或者 缓冲区 为 NULL。 |
|
找不到与模式匹配的更多符号。 |
注解
搜索必须先由 StartSymbolMatch 初始化。 找到所有所需符号后, 可以使用 EndSymbolMatch 释放引擎保留的搜索资源。
有关符号的详细信息,请参阅 符号。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |