DebugCreateEx, fonction (dbgeng.h)

La fonction DebugCreateEx crée un objet client et retourne un pointeur d’interface vers celui-ci.

Syntaxe

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

Paramètres

[in] InterfaceId

Spécifie l’identificateur d’interface (IID) de l’interface cliente du moteur de débogueur souhaitée. Il s’agit du type de l’interface qui sera retournée dans Interface. Pour plus d’informations sur l’identificateur d’interface, consultez Utilisation d’objets clients.

[in] DbgEngOptions

Fournit des indicateurs d’option de débogueur.

[out] Interface

Reçoit un pointeur d’interface pour le nouveau client. Le type de cette interface est spécifié par InterfaceId.

Valeur retournée

Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La fonction a réussi.
E_NOINTERFACE	L’objet client n’implémente pas l’interface spécifiée.

Remarques

Les paramètres passés à DebugCreateEx sont les mêmes que ceux passés à IUnknown ::QueryInterface, et ils sont traités de la même façon.

Comme avec IUnknown ::QueryInterface, lorsque l’interface retournée n’est plus nécessaire, sa méthode IUnknown ::Release doit être appelée.

Vous n’avez pas besoin d’appeler CoInitialize, CoInitializeEx ou OleInitialize pour utiliser cette fonction et les interfaces obtenues par celle-ci.

Les interfaces clientes du moteur de débogueur ne peuvent pas être obtenues en appelant CoCreateInstance, CoCreateInstanceEx ou CoGetClassObject. Utilisez DebugCreate, DebugCreateEx, DebugConnect ou DebugConnectWide pour créer une telle interface, ou appelez IUnknown ::QueryInterface sur une autre interface cliente du moteur de débogueur.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

Fonctions clientes

Objets client