IDebugAdvanced2::GetSourceFileInformation メソッド (dbgeng.h)

GetSourceFileInformation メソッドは、ソース ファイルに関する指定された情報を返します。

構文

HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

パラメーター

[in] Which

返す情報の一部を指定します。 Which パラメーターは、次の表のいずれかの値を受け取ることができます。

DEBUG_SRCFILE_SYMBOL_TOKEN

ソース サーバー上の指定したソース ファイルを表すトークンを返します。 このトークンを FindSourceFileAndToken に渡して、ファイルに関する情報を取得できます。 トークンは、バイト配列として バッファー バッファーに返されます。 このトークンのサイズは、SrcSrv トークンのサイズを反映したものです。

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

ソース 管理からソース ファイルを抽出するコマンドのソース サーバーに対してクエリを実行します。 これには、実行可能ファイルの名前とそのコマンド ライン パラメーターが含まれます。 コマンドは、Unicode 文字列として バッファー バッファーに返されます。

[in] SourceFile

情報を要求するソース ファイルを指定します。 ソース ファイルは、ソース パス内のすべてのソース サーバーで検索されます。

[in] Arg64

64 ビット引数を指定します。 値 Which は、シンボル トークンが要求されるモジュールを指定します。 Which の値に関係なく、Arg64 はモジュールのメモリ割り当て内の場所です。

[in] Arg32

32 ビット引数を指定します。 このパラメーターは現在使用されていません。

[out, optional] Buffer

要求されたシンボル情報を受け取ります。 返されるデータの型は、 Which の値によって異なります。 BufferNULL の場合、この情報は返されません。

[in] BufferSize

バッファー バッファーのサイズをバイト単位で指定します。 BufferNULL の場合、BufferSizeNULL である必要があります。

[out, optional] InfoSize

バッファー バッファーに返される情報のサイズをバイト単位で指定します。 データが不要な場合、このパラメーターは NULL にすることができます。

戻り値

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

リターン コード 説明
S_OK
メソッドは正常に実行されました。
S_FALSE
メソッドは正常に実行されました。 ただし、情報は バッファー バッファーに収まらないため、情報または名前は切り捨てられました。

注釈

ソース ファイルの詳細については、「ソース ファイルの 使用」を参照してください。

要件

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

こちらもご覧ください

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3