IDebugSymbols2：：StartSymbolMatch 方法 (dbgeng.h)

StartSymbolMatch 方法初始化名称与给定模式匹配的符号的搜索。

语法

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

[in] Pattern

指定要搜索的模式。搜索将返回名称与此模式匹配的所有符号。有关模式语法的详细信息，请参阅符号语法和符号匹配和字符串通配符语法。

[out] Handle

接收标识搜索的句柄。此句柄可以传递给 GetNextSymbolMatch 和 EndSymbolMatch。

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

返回代码	说明
S_OK	方法成功。
E_NOINTERFACE	找不到指定的模块。

此方法初始化符号搜索。可以通过重复调用 GetNextSymbolMatch 来获取搜索结果。找到所有所需结果后，使用 EndSymbolMatch 释放引擎保留用于搜索的资源。

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

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