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

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

構文

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

パラメーター

[in] Offset

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

[out, optional] NameBuffer

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

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] Displacement

Offset の値とシンボルの基本位置の差を受け取ります。 Displacement が NULL の場合、この情報は返されません。

戻り値

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

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

注釈

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

要件

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

こちらもご覧ください

GetNearNameByOffset

GetOffsetByName

IDebugSymbols3