Esta documentación está archivada y no tiene mantenimiento.

/INCREMENTAL (Vincular de forma incremental)

/INCREMENTAL[:NO]

La opción /INCREMENTAL controla la forma en que el vinculador aplica la vinculación incremental.

De manera predeterminada, el vinculador se ejecutará en modo incremental. Para reemplazar un vínculo incremental predeterminado, deberá especificarse /INCREMENTAL:NO.

Un programa vinculado de forma incremental equivale en funcionalidad a un programa vinculado de forma no incremental. Sin embargo, al estar preparados para posteriores vínculos incrementales, los archivos ejecutables (.exe) y las bibliotecas de vínculos dinámicos (DLL) que se vinculen de manera incremental:

  • Tendrán, a causa del relleno del código y los datos, un tamaño mayor que los programa vinculados de manera no incremental. (El relleno le permite al vinculador aumentar el tamaño de las funciones y los datos sin tener que volver a crear el archivo .exe.)

  • Pueden contener códigos thunk de salto para controlar la reubicación de las funciones en direcciones nuevas.

    NoteNota

    Para asegurarse de que la versión final de la generación no contenga ningún relleno ni códigos thunk, será necesario vincular el programa de forma no incremental.

Para vincular de forma incremental con independencia del valor predeterminado, especifique /INCREMENTAL. Si, al seleccionar esta opción, el vinculador no puede establecer el vínculo incremental, emitirá una advertencia y, después, vinculará el programa de manera no incremental. Determinadas opciones y situaciones reemplazan a /INCREMENTAL.

La mayoría de los programas pueden vincularse de manera incremental. Sin embargo, algunos cambios son demasiado grandes y determinadas opciones son incompatibles con la vinculación incremental. LINK realizará un vínculo completo si se especifica cualquiera de las opciones siguientes:

  • No se selecciona la vinculación incremental (/INCREMENTAL:NO)

  • Se selecciona /OPT:REF

  • Selecciona /OPT:ICF

  • Se selecciona /ORDER

La opción /INCREMENTAL está implícita cuando se especifica /DEBUG.

Asimismo, LINK realizará un vínculo completo si se da alguna de las situaciones siguientes:

  • Falta el archivo de estado incremental (.ilk). (LINK crea un archivo .ilk nuevo como preparación para una posterior vinculación incremental.)

  • No se cuenta con permiso de escritura para el archivo .ilk. (LINK hace caso omiso del archivo .ilk y produce un vínculo no incremental.)

  • Falta el archivo de resultados .exe o .dll.

  • Se ha modificado la marca de hora del archivo .ilk, .exe o .dll.

  • Se ha modificado una opción de LINK. La mayoría de las opciones de LINK, si se cambian entre generaciones, producen un vínculo completo.

  • Se ha agregado u omitido un archivo objeto (.obj).

  • Se ha modificado un objeto compilado con la opción /Yu /Z7.

Para establecer esta opción del vinculador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para obtener más información, vea Establecer las propiedades de un proyecto de Visual C++.

  2. Haga clic en la carpeta Vinculador.

  3. Haga clic en la página de propiedades General.

  4. Modifique la propiedad Habilitar vinculación incremental.

Para establecer esta opción del vinculador mediante programación

Mostrar: