構文:
/INCREMENTAL:{YES | NO}
リンカーが増分リンクをどのように処理するかを制御します。基本設定では,リンカーは増分モードで動作します (例外については,「/[no]traceback」を参照)。
増分リンクを禁止するには,「Customize」カテゴリの「Link Incrementally」チェックボックスをクリアするか,コマンド行で /INCREMENTAL:NO を指定します。
増分リンクを行うには,「Link Incrementally」チェックボックスを設定します (またはコマンド行で /INCREMENTAL:YES を指定します)。このオプションを指定した場合,リンカーは,増分リンクを行えないときには警告を発行し,非増分リンクを行います。一部のオプションと状況は,/INCREMENTAL:YES を置換します。
ほとんどのプログラムは増分リンクを行うことができます。ただし,変更が大きすぎることもありますし,オプションによっては増分リンクとの互換性がないものもあります。LINK は,次のいずれかのオプションが指定されていると,全リンクを実行します。
「Link Incrementally」がオフにされたとき (/INCREMENTAL:NO)
COFF フォーマット (/DEBUGTYPE:COFF)
両方のフォーマット (/DEBUGTYPE:BOTH)
/OPT:REF が選択されたとき
/OPT:ICF が選択されたとき
/ORDER が選択されたとき
「Generate Debug Info」(/DEBUG) が指定されていて,「Use program Database」がオフにされたとき (/PDB:NONE)
さらに,LINK は次のいずれかが起こった場合,すべてをリンクします。
増分状況 (.ILK) ファイルがない。LINK は,後に増分リンクを行う準備として,新しい .ILK ファイルを作成します。
.ILK ファイルに対する書き込み権がない。LINK は .ILK ファイルを無視し,非増分リンクを行います。
.EXE または .DLL 出力ファイルがない。
.ILK,.EXE,または .DLL のタイムスタンプが変更されている。
LINK オプションが変更された。ほとんどの LINK オプションは,ビルド間で変更されていると,すべてをリンクします。
オブジェクト・ファイル (.OBJ) が追加または省略された。
/Yu /Z7 オプションでコンパイルされたオブジェクトが変更された。
ビジュアル開発環境でこのオプションを選択するには,「Project Settings」ダイアログボックスの「Link」タブの「Customize」カテゴリで「Link Incrementally」チェックボックスを選択します。