Replacing Place Files with Build Macros

The BINPLACE_PLACEFILE macro, along with the BinPlace place file, is obsolete. You should not use this macro or a place file. Instead, use the following macros to specify the path and names of files to be placed by BinPlace:

• TARGET_DESTINATION

• PASS0_BINPLACE

• PASS1_BINPLACE

• PASS2_BINPLACE

The following methods describe how you can use these macros instead of using a BinPlace place file:

• If you are using BinPlace to put a file (specified by the TARGETNAME macro) to any directory, use TARGET_DESTINATION in your Sources file as shown in the following example:

  TARGET_DESTINATION=DirectoryName
  

• If you are using BinPlace to put a file (specified by the TARGETNAME macro) to the root of a directory tree (specified by the _NTTREE macro), use TARGET_DESTINATION in your Sources fileas shown in the following example:

  TARGET_DESTINATION=retail
  

• If you are using BinPlace to put files that are not built or changed by the build process, use the PASS0_BINPLACE, PASS1_BINPLACE, or PASS2_BINPLACE macros.

  By default, these macros use the destination directory that is specified by the TARGET_DESTINATION macro. You can override this default by adding the following for each file within the FileList parameter of the PASS0_BINPLACE, PASS1_BINPLACE, or PASS2_BINPLACE macros:

  -:DEST altDest FileName
  

• If you are using BinPlace to put a file that is not specified by the TARGETNAME macro, use either the PASS1_BINPLACE or PASS2_BINPLACE macros.

Send comments about this topic to Microsoft

Build date: 2/6/2012