DebugConnect-Funktion (dbgeng.h)

Artikel
02/27/2024

Die Funktionen DebugConnect und DebugConnectWide erstellen ein neues Clientobjekt und geben einen Schnittstellenzeiger darauf zurück. Das Clientobjekt wird mit einem Remotehost verbunden.

Syntax

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parameter

[in] RemoteOptions

Gibt an, wie die Debugger-Engine eine Verbindung mit dem Remotehost herstellt. Dies sind die gleichen Optionen, die an die Option -remote in der Befehlszeile übergeben werden. Ausführliche Informationen zur Syntax dieser Zeichenfolge finden Sie unter Aktivieren eines Debugclients.

[in] InterfaceId

Gibt den Schnittstellenbezeichner (Interface Identifier, IID) der client-Schnittstelle der gewünschten Debugger-Engine an. Dies ist der Typ der Schnittstelle, die in Interface zurückgegeben wird. Informationen zum Schnittstellenbezeichner finden Sie unter Verwenden von Clientobjekten.

[out] Interface

Empfängt einen Schnittstellenzeiger für den neuen Client. Der Typ dieser Schnittstelle wird durch InterfaceId angegeben.

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

Wie bei IUnknown::QueryInterface sollte die IUnknown::Release-Methode aufgerufen werden, wenn die zurückgegebene Schnittstelle nicht mehr benötigt wird.

Sie müssen CoInitialize, CoInitializeEx oder OleInitialize nicht aufrufen, um diese Funktion und die von ihr abgerufenen Schnittstellen zu verwenden.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

Clientobjekte

Prozessserver und Smart Client

Freigeben über