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
S_OK	La funzione ha avuto esito positivo.
E_NOINTERFACE	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)

Vedi anche

Oggetti client