次の方法で共有

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

  • [アーティクル]

GetNameByOffset メソッドは、ターゲットの仮想アドレス空間内の指定した場所にあるシンボルの名前を返します。

構文

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

パラメーター

[in] Offset

名前が要求されるシンボルのターゲットの仮想アドレス空間内の場所を指定します。 オフセット はシンボルの基本位置を指定する必要はありません。シンボルのメモリ割り当て内の場所を指定するだけで済みます。

[out, optional] NameBuffer

シンボルの名前を受け取ります。 この名前は、シンボルが属するモジュールによって修飾されます (たとえば、mymodule!main )。 NameBuffer が NULL 場合、この情報は返されません。

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] Displacement

オフセット の値とシンボルの基本位置の差を受け取ります。 ディスプレイスメント が NULL 場合、この情報は返されません。

戻り値

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

リターン コード 形容
S_OK
 メソッドが成功しました。
S_FALSE
 メソッドが成功しました。 ただし、バッファーはシンボルの名前を保持するのに十分な大きさではないため、切り捨てられました。
E_FAIL
 指定した場所にシンボルが見つかりませんでした。

備考

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

必要条件

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

関連項目

GetNearNameByOffset を する

GetOffsetByName の

IDebugSymbols

IDebugSymbols2 を する

IDebugSymbols3