Funzione DebugCreateEx (dbgeng.h)

La funzione DebugCreateEx crea un nuovo oggetto client e restituisce un puntatore all'interfaccia.

Sintassi

HRESULT DebugCreateEx(
  [in]  REFIID InterfaceId,
  [in]  DWORD  DbgEngOptions,
  [out] PVOID  *Interface
);

Parametri

[in] InterfaceId

Specifica l'identificatore di interfaccia (IID) dell'interfaccia client del motore di debugger desiderata. Questo è il tipo dell'interfaccia che verrà restituita in Interface. Per informazioni sull'identificatore dell'interfaccia, vedere Using Client Objects.

[in] DbgEngOptions

Fornisce i flag di opzione del debugger.

[out] Interface

Riceve un puntatore di 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	La funzione ha avuto esito positivo.
E_NOINTERFACE	L'oggetto client non implementa l'interfaccia specificata.

Osservazioni

I parametri passati a DebugCreateEx sono uguali a quelli passati a IUnknown::QueryInterfacee 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, CoInitializeExo OleInitialize per usare questa funzione e le interfacce ottenute.

Le interfacce client del motore di debugger non possono essere ottenute chiamando CoCreateInstance, CoCreateInstanceExo CoGetClassObject. Usare DebugCreare, DebugCreateEx, DebugConnecto DebugConnectWide per creare tale interfaccia o chiamare IUnknown::QueryInterface in un'altra interfaccia client del motore di debugger.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Vedere anche

funzioni client di

oggetti client