次の方法で共有


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 場合、次にこれらのメソッドの 1 つが呼び出されるときに (同じハンドルを使用して) 同じシンボルが再び返されます。これは、シンボルの名前のサイズを決定するために使用できます。

[in] BufferSize

バッファーのサイズを文字数で指定します。 このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] MatchSize

シンボルの名前のサイズを文字単位で受け取ります。 このサイズには、'\0' 終端文字のスペースが含まれます。 MatchSize NULL 場合、この情報は返されません。

[out, optional] Offset

シンボルのターゲットの仮想アドレス空間内の場所を受け取ります。 Offset が NULL 場合、この情報は返されません。

戻り値

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

リターン コード 形容
S_OK
メソッドが成功しました。
S_FALSE
バッファーのサイズがシンボルの名前に対して小さすぎたか、バッファー が NULL
E_NOINTERFACE
パターンに一致するシンボルが見つかりませんでした。

備考

検索は、最初に StartSymbolMatch 初期化する必要があります。 目的のすべてのシンボルが見つかったら、EndSymbolMatch を使用して、エンジンが検索に保持するリソースを解放できます。

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

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

EndSymbolMatch

IDebugSymbols3

StartSymbolMatch