Méthode IDebugClient3 ::SetKernelConnectionOptions (dbgeng.h)

Article
02/23/2024

La méthode SetKernelConnectionOptions met à jour certaines des options de connexion d’une cible de noyau dynamique.

Syntaxe

HRESULT SetKernelConnectionOptions(
  [in] PCSTR Options
);

Paramètres

[in] Options

Spécifie les options de connexion à mettre à jour. Les valeurs possibles sont les suivantes :

Valeur	Description
« resync »	Resynchroniser la connexion entre le moteur du débogueur et le noyau. Pour plus d’informations, consultez Synchronisation avec l’ordinateur cible.
« cycle_speed »	Pour les connexions de noyau via un port COM, parcourez les débits en bauds pris en charge ; pour les autres connexions, ne rien faire. Pour plus d’informations, consultez Ctrl+A (Basculer le taux de bauds).

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.
E_UNEXPECTED	La cible actuelle n’est pas une cible de noyau active (non locale).

Remarques

Cette méthode est disponible uniquement pour les cibles de noyau dynamique qui ne sont pas locales et qui ne sont pas connectées via eXDI. Cette méthode est réentrée.

Pour plus d’informations sur la connexion à des cibles en mode noyau actif, consultez Cibles de Kernel-Mode en direct.