ホーム › System.Diagnostics.Debug › SYMADDSOURCESTREAMA

SYMADDSOURCESTREAMA

コールバック

シグネチャ

BOOL SYMADDSOURCESTREAMA(
    HANDLE param0,
    ULONGLONG param1,
    LPSTR param2,
    BYTE* param3,
    UINT_PTR param4
);

パラメーター

フィールド	型
param0	HANDLE
param1	ULONGLONG
param2	LPSTR
param3	BYTE*
param4	UINT_PTR

公式ドキュメント

指定したモジュールに、Source Server が使用するストリームを追加します。

戻り値

関数が成功した場合、戻り値は TRUE です。

関数が失敗した場合、戻り値は FALSE です。拡張エラー情報を取得するには、 GetLastError を呼び出します。

解説(Remarks)

SymAddSourceStream は、source Server が使用する形式に整形されたデータストリームを、指定したモジュールに追加します。呼び出し元は、Buffer パラメーターにバッファーとして渡すことも、StreamFile パラメーターにファイルとして渡すこともできます。両方のパラメーターが指定されている場合、この関数は Buffer パラメーターを使用します。両方のパラメーターが NULL の場合、この関数は FALSE を返し、最終エラーコードに ERROR_INVALID_PARAMETER が設定されます。

SymAddSourceStream は、データを永続化するために対応する PDB にストリームを追加するわけではない点に注意してください。この関数は、PDB が利用できない状況で独自のデバッガーをプログラムから実装する場合に使用されます。

メモ

dbghelp.h ヘッダーは、SymAddSourceStream を UNICODE プリプロセッサー定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立なエイリアスと、エンコーディング中立ではないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)