Udostępnij przez

IDebugEngineLaunch2::LaunchSuspended

  • Artykuł

Ta metoda uruchamia proces za pomocą aparatu debugowania (DE).

Składnia

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
[in] Nazwa maszyny, w której ma być uruchamiany proces. Użyj wartości null, aby określić maszynę lokalną.

pPort
[in] Interfejs IDebugPort2 reprezentujący port, w ramach którego zostanie uruchomiony program.

pszExe
[in] Nazwa pliku wykonywalnego do uruchomienia.

pszArgs
[in] Argumenty przekazywane do pliku wykonywalnego. Może być wartością null, jeśli nie ma argumentów.

pszDir
[in] Nazwa katalogu roboczego używanego przez plik wykonywalny. Może być wartością null, jeśli nie jest wymagany katalog roboczy.

bstrEnv
[in] Blok środowiskowy ciągów zakończonych wartościami NULL, a następnie dodatkowy terminator o wartości NULL.

pszOptions
[in] Opcje pliku wykonywalnego.

dwLaunchFlags
[in] Określa LAUNCH_FLAGS dla sesji.

hStdInput
[in] Dojście do alternatywnego strumienia wejściowego. Może być równa 0, jeśli przekierowanie nie jest wymagane.

hStdOutput
[in] Dojmij do alternatywnego strumienia wyjściowego. Może być równa 0, jeśli przekierowanie nie jest wymagane.

hStdError
[in] Obsługa alternatywnego strumienia danych wyjściowych błędów. Może być równa 0, jeśli przekierowanie nie jest wymagane.

pCallback
[in] Obiekt IDebugEventCallback2 , który odbiera zdarzenia debugera.

ppDebugProcess
[out] Zwraca wynikowy obiekt IDebugProcess2 reprezentujący uruchomiony proces.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca wartość S_OK; w przeciwnym razie zwraca kod błędu.

Uwagi

Zwykle program Visual Studio uruchamia program przy użyciu metody LaunchSuspended , a następnie dołącza debuger do zawieszonego programu. Istnieją jednak okoliczności, w których aparat debugowania może wymagać uruchomienia programu (na przykład jeśli aparat debugowania jest częścią interpretera, a debugowany program jest językiem interpretowanym), w tym przypadku program Visual Studio używa IDebugEngineLaunch2::LaunchSuspended metody .

Metoda ResumeProcess jest wywoływana w celu uruchomienia procesu po pomyślnym uruchomieniu procesu w stanie wstrzymania.

Zobacz też