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

[アーティクル]
02/26/2024

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

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

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

戻り値

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

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