Sdílet prostřednictvím

IDebugEngineLaunch2::LaunchSuspended

  • Článek

Tato metoda spustí proces pomocí ladicího stroje (DE).

Syntaxe

int LaunchSuspended(
   string               pszServer,
   IDebugPort2          pPort,
   string               pszExe,
   string               pszArgs,
   string               pszDir,
   string               bstrEnv,
   string               pszOptions,
   enum_LAUNCH_FLAGS    dwLaunchFlags,
   uint                 hStdInput,
   uint                 hStdOutput,
   uint                 hStdError,
   IDebugEventCallback2 pCallback,
   out IDebugProcess2   ppProcess
);

Parametry

pszMachine
[v] Název počítače, ve kterém se má proces spustit. K určení místního počítače použijte hodnotu null.

pPort
[v] Rozhraní IDebugPort2 představující port, ve které bude program běžet.

pszExe
[v] Název spustitelného souboru, který se má spustit.

pszArgs
[v] Argumenty, které se mají předat spustitelnému souboru. Pokud neexistují žádné argumenty, může mít hodnotu null.

pszDir
[v] Název pracovního adresáře používaného spustitelným souborem. Pokud není vyžadován žádný pracovní adresář, může mít hodnotu null.

bstrEnv
[v] Blok prostředí řetězců ukončených hodnotou NULL následovaný dodatečným ukončovacím znakem NULL.

pszOptions
[v] Možnosti spustitelného souboru.

dwLaunchFlags
[v] Určuje LAUNCH_FLAGS relace.

hStdInput
[v] Popisovač alternativního vstupního streamu Pokud přesměrování není povinné, může být 0.

hStdOutput
[v] Zpracování alternativního výstupního datového proudu Pokud přesměrování není povinné, může být 0.

hStdError
[v] Zpracování alternativního výstupního datového proudu chyby Pokud přesměrování není povinné, může být 0.

pCallback
[v] IDebugEventCallback2 objekt, který přijímá události ladicího programu.

ppDebugProcess
[ven] Vrátí výsledný IDebugProcess2 objekt, který představuje spuštěný proces.

Vrácená hodnota

V případě úspěchu vrátí hodnotu S_OK; v opačném případě vrátí kód chyby.

Poznámky

Za normálních okolností Visual Studio spustí program pomocí metody LaunchSuspended a pak připojí ladicí program k pozastavené aplikaci. Existují však okolnosti, kdy ladicí modul může potřebovat spustit program (například pokud ladicí modul je součástí interpretu a laděný program je interpretovaný jazyk), v takovém případě Visual Studio tuto metodu IDebugEngineLaunch2::LaunchSuspended používá.

Metoda ResumeProcess je volána ke spuštění procesu po úspěšném spuštění procesu v pozastaveném stavu.

Viz také