IDebugClient5::StartProcessServerWide-Methode (dbgeng.h)

Artikel
02/23/2024

Die StartProcessServerWide-Methode startet einen Prozessserver.

Syntax

HRESULT StartProcessServerWide(
  [in]           ULONG  Flags,
  [in]           PCWSTR 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 zur Verfügung gestellt werden. Ausführliche Informationen zur Syntax dieser Zeichenfolge finden Sie unter Aktivieren eines Prozessservers.

[in, optional] Reserved

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.

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 es Ausführen verwenden, 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 Smart Clients.