Fonction DebugConnect (dbgeng.h)

  • Article

Les fonctions DebugConnect et DebugConnectWide créent un objet client et retournent un pointeur d’interface vers celui-ci. L’objet client sera connecté à un hôte distant.

Syntaxe

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Paramètres

[in] RemoteOptions

Spécifie la façon dont le moteur du débogueur se connecte à l’hôte distant. Il s’agit des mêmes options qui sont transmises à l’option -remote sur la ligne de commande. Pour plus d’informations sur la syntaxe de cette chaîne, consultez Activation d’un client de débogage.

[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 Utilisation d’objets client.

[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 des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Code de retour Description
S_OK
 La méthode a réussi.

Remarques

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.

Configuration requise

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

Voir aussi

Objets clients

Serveur de processus et client intelligent