Add ALLOW_BUILD_FAIL option to add_cmake_build_test.

Sometimes we want to ensure that a build fails, so add a new option to allow
that to happen and then check for it later in the Verify stage.