DebugCreateEx-Funktion (dbgeng.h)
Die DebugCreateEx--Funktion erstellt ein neues Clientobjekt und gibt einen Schnittstellenzeiger darauf zurück.
HRESULT DebugCreateEx(
[in] REFIID InterfaceId,
[in] DWORD DbgEngOptions,
[out] PVOID *Interface
);
[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.
[in] DbgEngOptions
Liefert Debuggeroptionskennzeichnungen.
[out] Interface
Empfängt einen Schnittstellenzeiger für den neuen Client. Der Typ dieser Schnittstelle wird durch InterfaceIdangegeben.
Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion war erfolgreich. |
|
Das Clientobjekt implementiert die angegebene Schnittstelle nicht. |
Die parameter, die an DebugCreateEx übergeben werden, sind identisch mit den Parametern, die an IUnknown::QueryInterfaceübergeben werden, und sie werden auf die gleiche Weise behandelt.
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.
Die Clientschnittstellen des Debuggermoduls können nicht durch Aufrufen CoCreateInstance, CoCreateInstanceEx-oder CoGetClassObject-abgerufen werden. Verwenden Sie DebugCreate, DebugCreateEx, DebugConnectoder DebugConnectWide, um eine solche Schnittstelle zu erstellen, oder rufen Sie IUnknown::QueryInterface auf einer anderen Clientschnittstelle des Debuggermoduls auf.
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | dbgeng.h (include Dbgeng.h) |