IVsSolutionBuildManager.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.

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Подпись COM

Из всшелл. IDL:

HRESULT IVsSolutionBuildManager::DebugLaunch(  
   [in] VSDBGLAUNCHFLAGS grfLaunch  
);  

Диспетчер сборки решения отслеживает запускаемый проект или проекты, для которых будет выполняться операция, когда нажата клавиша F5 с помощью записей на страницах свойств конфигурации решения . IVsSolutionBuildManager вызывается средой, чтобы определить, когда будет включен ключ F5 . Если среда находится в режиме отладки, она отключает клавишу F5 до тех пор, пока отладка не достигнет точки останова. в этом случае клавиша F5 будет включена командой Continue или при остановке отладки, в этом случае клавиша F5 будет включена с помощью команды Start .

При нажатии клавиши F5 DebugLaunch вызывается компонентом диспетчера отладки среды для начала операции с запускаемым проектом или проектами. В этот момент среда вызывает Ивсдебуггаблепрожекткфг:: DebugLaunch в активной конфигурации проекта каждого запускаемого из проектов, который запускает сеанс отладки в целевом объекте конфигурации проекта, используя сведения, относящиеся к конкретному проекту.

Примечание

Запущенным отладчиком может быть управляемый или машинный отладчик от корпорации Майкрософт, или собственный, разработанный в качестве разработчика VSIP.

IVsSolutionBuildManager знает, какой проект или проекты следует включить в процесс сборки на основе параметров на страницах свойств конфигурации решения, а отдельные проекты знают, что необходимо выполнить при DebugLaunch вызове, на основе параметров конфигурации, отображаемых на страницах свойств конфигурации проекта . Дополнительные сведения см. в разделе Управление параметрами конфигурации.

В некоторых случаях может потребоваться наличие пакета, отличного от запуска отладчика при нажатии клавиши F5 . В этом случае пакет VSPackage, реализованный в его реализации IVsSolutionBuildManager и DebugLaunch , определяет запускаемый проект или проекты, с которыми будет работать и начать обработку пакета.

Применяется к