Funzione DebugCreate (dbgeng.h)
La funzione DebugCreate crea un nuovo oggetto client e restituisce un puntatore dell'interfaccia.
Sintassi
HRESULT DebugCreate(
[in] REFIID InterfaceId,
[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.
[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 DebugCreate sono uguali a quelli passati a IUnknown::QueryInterface e vengono trattati nello 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) |