`/INCREMENTAL` (増分リンク)

増分リンクするか、または常にフルリンクを実行するかを指定します。

構文

/INCREMENTAL[:NO]

リンカーオプションは /INCREMENTAL 、リンカーがインクリメンタルリンクを処理する方法を制御します。

既定では、インクリメンタルリンクは実行されます。既定の増分リンクをオーバーライドするには、次のように指定します /INCREMENTAL:NO。

インクリメンタルリンクされたプログラムは、インクリメンタルリンクではないプログラムと機能的には同等です。ただし、後続の増分リンク用に準備されているため、増分リンクされた実行可能ファイル、スタティックライブラリ、またはダイナミックリンクライブラリファイルは次のようになります。

コードとデータのパディングにより、インクリメンタルリンクされていないプログラムより大きくなります。パディングを行うと、リンカーは、ファイルを再作成することなく、関数やデータのサイズを拡張できます。
ジャンプサンクを使って、新しいアドレスに関数を再配置する場合があります。

Note

最終リリースビルドにパディングやサンクが含まれないようにするには、プログラムをインクリメンタルにしないでリンクします。

既定値に関係なく増分リンクするには、次のように指定します /INCREMENTAL。このオプションを選択すると、リンカーは増分リンクできない場合に警告を発行し、プログラムを非増分リンクします。特定のオプションと状況がオーバーライドされます /INCREMENTAL。

大半のプログラムでは、インクリメンタルリンクができます。ただし、変更箇所が大きすぎたり、インクリメンタルリンクと矛盾するオプションが指定されていると、実行できません。フルリンクを実行するには、次のいずれかを行います。

/INCREMENTAL は、指定された場合 /DEBUG に暗黙的に指定されます。

以下の場合もフルリンクが行われます。

増分状態 (.ilk) ファイルがありません。 (LINK は、後続の増分リンクの準備として新しい .ilk ファイルを作成します)。
ファイルに対する .ilk 書き込みアクセス許可がありません。 (LINK ではファイルが .ilk 無視され、リンクは増分的に無視されます)。
.exeまたは.dll出力ファイルがありません。
、、または.dll変更されたタイムスタンプ。.ilk.exe
LINK オプションを変更した場合。ビルド間で LINK オプションを変更すると、ほとんどの場合、フルリンクが行われます。
オブジェクト (.obj) ファイルが追加または省略されます。

増分リンクは、増分リンクデータベース .ilk ファイルを作成または更新します。 (増分データベースファイルの名前) リンカーオプションを使用して、このファイルの名前と場所を/ILK指定できます。ファイルの詳細.ilkについては、リンカー入力としてのファイルを参照してください.ilk。

プロジェクトの [プロパティページ] ダイアログボックスを開きます。詳細については、Visual Studio での C++ コンパイラとビルドプロパティの設定に関する記事を参照してください。
[構成プロパティ]>[リンカー]>[全般] プロパティページを選択します。
[インクリメンタルリンクを有効にする] プロパティを変更します。