DebugCreate-Funktion (dbgeng.h)

Die DebugCreate-Funktion erstellt ein neues Clientobjekt und gibt einen Schnittstellenzeiger darauf zurück.

Syntax

HRESULT DebugCreate(
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parameter

[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 andere Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Funktion war erfolgreich.
E_NOINTERFACE	Das Clientobjekt implementiert die angegebene Schnittstelle nicht.

Hinweise

Die an DebugCreate übergebenen Parameter sind identisch mit denen, die an IUnknown::QueryInterface übergeben werden, und sie werden auf die gleiche Weise behandelt.

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.

Die Clientschnittstellen der Debugger-Engine können nicht durch Aufrufen von CoCreateInstance, CoCreateInstanceEx oder CoGetClassObject abgerufen werden. Verwenden Sie DebugCreate, DebugCreateEx, DebugConnect oder DebugConnectWide , um eine solche Schnittstelle zu erstellen, oder rufen Sie IUnknown::QueryInterface auf einer anderen Clientschnittstelle der Debugger-Engine auf.

Anforderungen

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

Weitere Informationen

Clientobjekte