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)