DebugCreateEx-Funktion (dbgeng.h)
Die DebugCreateEx-Funktion erstellt ein neues Clientobjekt und gibt einen Schnittstellenzeiger darauf zurück.
Syntax
HRESULT DebugCreateEx(
[in] REFIID InterfaceId,
[in] DWORD DbgEngOptions,
[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.
[in] DbgEngOptions
Stellt Debuggeroptionsflags bereit.
[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 |
|---|---|
|
Die Funktion war erfolgreich. |
|
Das Clientobjekt implementiert die angegebene Schnittstelle nicht. |
Hinweise
Die an DebugCreateEx ü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) |