Tests: Extend RunCMake.SymlinkTrees to verify paths passed to compiler

Verify that the paths to source files and include directories
are passed to the compiler with the symlinks preserved.