DebugCreateEx, fonction (dbgeng.h)

Article
02/06/2025

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é. Il s’agit du type de l’interface qui sera retournée dans Interface. Pour plus d’informations sur l’identificateur d’interface, consultez Using Client Objects.

[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 de retour

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

Retourner le code	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 identiques à 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, son méthode IUnknown ::Release doit être appelée.

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

Impossible d’obtenir les interfaces clientes du moteur de débogueur en appelant CoCreateInstance, CoCreateInstanceExou CoGetClassObject. Utilisez DebugCreate, DebugCreateEx, DebugConnectou DebugConnectWide pour créer une telle interface ou appeler IUnknown ::QueryInterface sur une autre interface cliente du moteur de débogage.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

fonctions clientes

objets clients

Partager via