DebugConnectWide-Funktion (dbgeng.h)

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 DebugConnectWide(
  [in]  PCWSTR RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parameter

[in] RemoteOptions

Gibt an, wie das Debuggermodul 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 (IID) der gewünschten Clientschnittstelle des Debuggermoduls an. Dies ist der Typ der Schnittstelle, die in Interfacezurü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 InterfaceIdangegeben.

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

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

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

Clientfunktionen

Clientobjekte