IVsSolutionBuildManager2.DebugLaunch(UInt32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает запускаемый проект, указанный в решении в виде проекта отладки.
public:
int DebugLaunch(System::UInt32 grfLaunch);
public:
int DebugLaunch(unsigned int grfLaunch);
int DebugLaunch(unsigned int grfLaunch);
public int DebugLaunch (uint grfLaunch);
abstract member DebugLaunch : uint32 -> int
Public Function DebugLaunch (grfLaunch As UInteger) As Integer
Параметры
- grfLaunch
- UInt32
[in] Задает флаги запуска. Дополнительные сведения см. в разделе __VSDBGLAUNCHFLAGS.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Реализации
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsSolutionBuildManager2::DebugLaunch(
[in] VSDBGLAUNCHFLAGS grfLaunch
);
Диспетчер сборки решения отслеживает запускаемый проект или проекты, для которых будет выполняться операция, когда нажата клавиша F5 с помощью записей на страницах свойств конфигурации решения. IVsSolutionBuildManager2 вызывается средой, чтобы определить, когда будет включен ключ F5 . Если среда находится в режиме отладки, она отключает клавишу F5 до тех пор, пока отладка не достигнет точки останова. в этом случае клавиша F5 будет включена командой Continue или при остановке отладки, в этом случае клавиша F5 будет включена с помощью команды Start.
При нажатии клавиши F5 DebugLaunch вызывается компонентом диспетчера отладки среды для начала операции с запускаемым проектом или проектами. В этот момент среда вызывает DebugLaunch в активной конфигурации проекта каждого запускаемого из проектов, который запускает сеанс отладки в целевом объекте конфигурации проекта, используя сведения, относящиеся к конкретному проекту.
Примечание
Запущенным отладчиком может быть управляемый или машинный отладчик от корпорации Майкрософт, или собственный, разработанный в качестве разработчика VSIP.
IVsSolutionBuildManager2 знает, какой проект или проекты следует включить в процесс сборки на основе параметров на страницах свойств конфигурации решения, а отдельные проекты знают, что необходимо выполнить при DebugLaunch вызове, на основе параметров конфигурации, отображаемых на страницах свойств конфигурации проекта. Дополнительные сведения см. в разделе Управление параметрами конфигурации.
В некоторых случаях может потребоваться наличие пакета, отличного от запуска отладчика при нажатии клавиши F5 . В этом случае VSPackage, через его реализацию IVsSolutionBuildManager2 и DebugLaunch , определяет запускаемый проект или проекты, с которыми будет работать пакет, и начинает обработку.