Параметр /Yl (вставка ссылки на PCH-файл для библиотеки отладки)

Этот параметр используется в случае сбоя при создании библиотеки отладки, в которой используются предкомпилированные заголовки.

/Ylsymbol

/Yl-

Аргументы

  • symbol
    Произвольный символ, который сохраняется в модуле объекта.

  • -
    Знак " минус " (-), явно отказывает параметр компилятора /Yl.

Заметки

По умолчанию компилятор использует параметр /Yl (без указания символ).Параметр /Yl позволяет отладчику получить полные сведения о типах./Yl- запрещает по умолчанию применяются расширения функциональности.

При компиляции модуля с использованием параметров /Yc и /Ylsymbol компилятор создает и сохраняет в модуле объекта символ вида __@@_PchSym_@00@...@symbol, где многоточие (...) представляет создаваемую компоновщиком строку символов.Любой исходный файл, компилированный с помощью предкомпилированного заголовка, относится к заданному символу, вследствие чего компоновщик включает из библиотеки модуль объекта и данные о его отладке.

При использовании этого параметра может возникнуть ошибка LNK1211.Если заданы параметры /Yc (создать предварительно скомпилированный заголовочный файл) и /Z7, /Zi, /ZI (формат отладочной информации), компилятор создает файл предкомпилированного заголовка, в котором содержатся сведения об отладке.При сохранении предкомпилированного заголовка в библиотеке, при использовании библиотеки для построения модуля объекта, а также если в исходном коде отсутствуют ссылки на какие-либо функции, определенные в файле предкомпилированного заголовка, может возникнуть ошибка.

Чтобы устранить эту проблему, при создании файла предкомпилированного заголовка, в котором отсутствуют определения функций, задайте параметр /Ylsymbol, где symbol — это имя произвольного символа в библиотеке.Этот параметр задает сохранение сведений об отладке в файле предкомпилированного заголовка.

Дополнительные сведения о предкомпилированных заголовках см. в разделах:

Установка данного параметра компилятора в среде разработки Visual Studio

  1. Откройте диалоговое окно Страницы свойств проекта.Дополнительные сведения см. в разделе Открытие свойств страниц проекта.

  2. Откройте папку C/C++.

  3. Выберите страницу свойств Командная строка.

  4. Введите параметр компилятора в поле Дополнительные параметры.

Установка данного параметра компилятора программным способом

  • Дополнительные сведения см. в разделе AdditionalOptions.

См. также

Ссылки

Параметры компилятора

Настройка параметров компилятора