IDebugClient2::StartProcessServer-Methode (dbgeng.h)

Artikel
02/23/2024

Die StartProcessServer-Methode startet einen Prozessserver.

Syntax

HRESULT StartProcessServer(
  [in]           ULONG Flags,
  [in]           PCSTR Options,
  [in, optional] PVOID Reserved
);

Parameter

[in] Flags

Gibt die Klasse der Ziele an, die über den Prozessserver verfügbar sein werden. Dies muss auf DEBUG_CLASS_USER_WINDOWS festgelegt werden.

[in] Options

Gibt die Verbindungsoptionen für diesen Prozessserver an. Dies sind die gleichen Optionen, die der Option -t der DbgSrv-Befehlszeile zugewiesen werden. Ausführliche Informationen zur Syntax dieser Zeichenfolge finden Sie unter Aktivieren eines Prozessservers.

[in, optional] Reserved

Auf NULL festgelegt.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Auf den gestarteten Prozessserver können Remoteclients über den im Options-Parameter angegebenen Transport zugreifen.

Verwenden Sie die EndProcessServer-Methode , um den Prozessserver über den smarten Client zu beenden. Um den Prozessserver von dem Computer herunterzufahren, auf dem er ausgeführt wird, verwenden Sie den Task-Manager, um den Prozess zu beenden. Wenn der instance der Debugger-Engine, die StartProcessServer verwendet hat, weiterhin ausgeführt wird, kann execute verwendet werden, um den Debuggerbefehl .endsrv 0 auszusetzen, der den Prozessserver beendet (dies ist eine Ausnahme vom üblichen Verhalten von .endsrv, das sich in der Regel nicht auf Prozessserver auswirkt).

Weitere Informationen zu Prozessservern und Remotedebuggen finden Sie unter Prozessserver, Kernelverbindungsserver und Intelligente Clients.