IDebugSymbols::StartSymbolMatch メソッド (dbgeng.h)

StartSymbolMatch メソッドは、名前が特定のパターンと一致するシンボルの検索を初期化します。

構文

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

[in] Pattern

検索するパターンを指定します。検索では、このパターンに一致する名前を持つすべてのシンボルが返されます。パターンの構文の詳細については、「シンボル構文」および「シンボルマッチング」および「文字列ワイルドカード構文」を参照してください。

[out] Handle

検索を識別するハンドルを受け取ります。このハンドルは、GetNextSymbolMatch と EndSymbolMatch に渡すことができます。

このメソッドは、他のエラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。
E_NOINTERFACE	指定したモジュールが見つかりませんでした。

このメソッドは、シンボル検索を初期化します。 GetNextSymbolMatch を繰り返し呼び出すことで、検索の結果を取得できます。必要なすべての結果が見つかったら、 EndSymbolMatch を使用して、エンジンが検索のために保持するリソースを解放します。

シンボルの詳細については、「シンボル」を参照してください。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)