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

Article
02/23/2024

La méthode GetKernelConnectionOptions retourne les options de connexion pour la cible actuelle du noyau.

Syntaxe

HRESULT GetKernelConnectionOptions(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG OptionsSize
);

Paramètres

[out, optional] Buffer

Spécifie la mémoire tampon pour recevoir les options de connexion.

[in] BufferSize

Spécifie la taille en caractères de la mémoire tampon. Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] OptionsSize

Reçoit la taille en caractères des options de connexion. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si OptionsSize a la valeur NULL, ces informations ne sont pas retournées.

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.
S_FALSE	La taille de la chaîne étant supérieure à la taille de la mémoire tampon, elle a été tronquée pour tenir dans la mémoire tampon.
E_UNEXPECTED	La cible actuelle n’est pas une cible de noyau dynamique standard.

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.

Les options de connexion retournées sont les mêmes que celles utilisées pour se connecter au noyau.

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

Configuration requise

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

Voir aussi