DebugConnectWide, fonction (dbgeng.h)

Article
02/06/2025

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

Syntaxe

HRESULT DebugConnectWide(
  [in]  PCWSTR RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Paramètres

[in] RemoteOptions

Spécifie la façon dont le moteur de débogueur se connecte à l’hôte distant. Il s’agit des mêmes options que celles 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 Using Client Objects.

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

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

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.

Exigences

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

Voir aussi

fonctions clientes

objets clients

Partager via