次の方法で共有


IDebugSymbols3::GetNextSymbolMatch メソッド (dbgeng.h)

GetNextSymbolMatch メソッドは、シンボル検索で見つかった次のシンボルを返します。

構文

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

パラメーター

[in] Handle

検索が初期化されたときに StartSymbolMatch によって返されるハンドルを指定します。

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

戻り値

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

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

注釈

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

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

要件

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

こちらもご覧ください

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch