Partager via

IDebugControl2 ::GetDebuggeeType, méthode (dbgeng.h)

  • Article

La méthode GetDebuggeeType décrit la nature de la cible actuelle.

Syntaxe

HRESULT GetDebuggeeType(
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Paramètres

[out] Class

Reçoit la classe de la cible actuelle. Elle est définie sur l’une des valeurs du tableau suivant.

Valeur Description
DEBUG_CLASS_UNINITIALIZED Il n’y a pas de cible actuelle.
DEBUG_CLASS_KERNEL La cible actuelle est une cible en mode noyau.
DEBUG_CLASS_USER_WINDOWS La cible actuelle est une cible en mode utilisateur.

[out] Qualifier

Fournit plus d’informations sur le type de la cible. Son interprétation dépend de la valeur de classe. Lorsque la classe est DEBUG_CLASS_UNINITIALIZED, qualificateur retourne zéro. Les valeurs suivantes s’appliquent aux cibles en mode noyau.

Valeur Description
DEBUG_KERNEL_CONNECTION La cible actuelle est un noyau actif débogué de la manière standard (à l’aide d’un port COM, d’un bus 1394 ou d’un canal nommé).
DEBUG_KERNEL_LOCAL La cible actuelle est le noyau local.
DEBUG_KERNEL_EXDI_DRIVER La cible actuelle est un noyau actif connecté à l’aide de pilotes eXDI.
DEBUG_KERNEL_SMALL_DUMP La cible actuelle est un fichier de vidage de mémoire de petite mémoire en mode noyau.
DEBUG_KERNEL_DUMP La cible actuelle est un fichier de vidage mémoire du noyau en mode noyau.
DEBUG_KERNEL_FULL_DUMP La cible actuelle est un fichier de vidage de mémoire complète en mode noyau.
 

Les valeurs suivantes s’appliquent aux cibles en mode utilisateur.

Valeur Description
DEBUG_USER_WINDOWS_PROCESS La cible actuelle est un processus en mode utilisateur sur le même ordinateur que le moteur de débogueur .
DEBUG_USER_WINDOWS_PROCESS_SERVER La cible actuelle est un processus en mode utilisateur connecté à l’aide d’un serveur de processus.
DEBUG_USER_WINDOWS_SMALL_DUMP La cible actuelle est un fichier Minidump en mode utilisateur.
DEBUG_USER_WINDOWS_DUMP La cible actuelle est un fichier de vidage complet User-Mode.

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.

Exigences

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