Funzione DebugCreateEx (dbgeng.h)
La funzione DebugCreateEx crea un nuovo oggetto client e restituisce un puntatore dell'interfaccia.
Sintassi
HRESULT DebugCreateEx(
[in] REFIID InterfaceId,
[in] DWORD DbgEngOptions,
[out] PVOID *Interface
);
Parametri
[in] InterfaceId
Specifica l'identificatore dell'interfaccia (IID) dell'interfaccia client del motore del debugger desiderata. Si tratta del tipo dell'interfaccia che verrà restituita in Interface. Per informazioni sull'identificatore dell'interfaccia, vedere Uso di oggetti client.
[in] DbgEngOptions
Fornisce i flag di opzione del debugger.
[out] Interface
Riceve un puntatore dell'interfaccia per il nuovo client. Il tipo di questa interfaccia viene specificato da InterfaceId.
Valore restituito
Questo metodo può anche restituire altri valori di errore. Per altre informazioni, vedere Valori restituiti .
| Codice restituito | Descrizione |
|---|---|
|
La funzione ha avuto esito positivo. |
|
L'oggetto client non implementa l'interfaccia specificata. |
Commenti
I parametri passati a DebugCreateEx sono uguali a quelli passati a IUnknown::QueryInterface e vengono trattati allo stesso modo.
Come per IUnknown::QueryInterface, quando l'interfaccia restituita non è più necessaria, è necessario chiamare il metodo IUnknown::Release .
Non è necessario chiamare CoInitialize, CoInitializeEx o OleInitialize per usare questa funzione e interfacce ottenute da esso.
Le interfacce client del motore di debugger non possono essere ottenute chiamando CoCreateInstance, CoCreateInstanceEx o CoGetClassObject. Usare DebugCreate, DebugCreateEx, DebugConnect o DebugConnectWide per creare tale interfaccia o chiamare IUnknown::QueryInterface in un'altra interfaccia client del motore di debugger.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | dbgeng.h (includere Dbgeng.h) |