Méthode IDebugClient4 ::GetKernelConnectionOptions (dbgeng.h)
La méthode GetKernelConnectionOptions retourne les options de connexion de la cible de noyau actuelle.
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 tampon. Cette taille inclut l’espace du caractère de fin « \0 ».
[out, optional] OptionsSize
Reçoit la taille en caractères des options de connexion. Cette taille inclut l’espace du caractère de fin « \0 ». Si OptionsSize est NULL, ces informations ne sont pas retournées.
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 |
|---|---|
|
La méthode a réussi. |
|
La taille de la chaîne était supérieure à la taille de la mémoire tampon, de sorte qu’elle était tronquée pour s’adapter à la mémoire tampon. |
|
La cible actuelle n’est pas une cible de noyau live standard. |
Remarques
Cette méthode est disponible uniquement pour les cibles de noyau dynamique qui ne sont pas locales et non 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 dynamique, consultez Cibles live Kernel-Mode.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include Dbgeng.h) |