IDebugClient4::StartProcessServer-Methode (dbgeng.h)

Artikel
02/06/2025

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 Befehlszeile von DbgSrv zugewiesen werden. Ausführliche Informationen zur Syntax dieser Zeichenfolge finden Sie unter Aktivieren eines Process Server-.

[in, optional] Reserved

Wird auf NULL-festgelegt.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Auf den gestarteten Prozessserver kann über den im Parameter Options angegebenen Transport von Remoteclients zugegriffen werden.

Verwenden Sie die EndProcessServer--Methode, um den Prozessserver vom Smart Client zu beenden. Um den Prozessserver vom Computer herunterzufahren, auf dem er ausgeführt wird, verwenden Sie den Task-Manager, um den Prozess zu beenden. Wenn die Instanz des Debuggermoduls, das StartProcessServer verwendet hat, weiterhin ausgeführt wird, kann es Execute verwenden, um den Debuggerbefehl .endsrv 0ausstellen, wodurch der Prozessserver beendet wird (dies ist eine Ausnahme vom üblichen Verhalten .endsrv, was sich im Allgemeinen nicht auf Prozessserver auswirkt).

Weitere Informationen zu Prozessservern und Remotedebugging finden Sie unter Prozessserver, Kernelverbindungsserver und smarte Clients.