Méthode IDebugRegisters2 ::SetValue (dbgeng.h)

Article
02/23/2024

La méthode SetValue définit la valeur de l’un des registres de la cible.

Syntaxe

HRESULT SetValue(
  [in] ULONG        Register,
  [in] PDEBUG_VALUE Value
);

Paramètres

[in] Register

Spécifie l’index du registre dont la valeur doit être définie.

[in] Value

Spécifie la valeur à laquelle définir le registre. Consultez DEBUG_VALUE pour obtenir une description de ce type de paramètre.

Valeur retournée

Cette liste ne contient pas toutes les erreurs qui peuvent se produire. Pour obtenir la liste des erreurs possibles, consultez Valeurs HRESULT.

Code de retour	Description
S_OK	La méthode a réussi.
E_UNEXPECTED	La cible n’est pas accessible ou le registre n’est pas accessible.
E_INVALIDARG	La valeur de Register est supérieure au nombre de registres sur l’ordinateur cible.

Remarques

Le moteur fait de son mieux pour forcer la valeur de Valeur dans le type du registre ; cette contrainte est la même que celle effectuée par CoerceValue. Si la valeur est supérieure à ce que le registre peut contenir, les bits les moins significatifs sont supprimés. Les conversions à virgule flottante et entière sont également effectuées si nécessaire.

Lorsqu’une sous-inscription est modifiée, le registre qui la contient est également modifié.

Pour définir les valeurs de plusieurs registres, utilisez plutôt la méthode SetValues .

Pour obtenir une vue d’ensemble de l’interface IDebugRegisters et d’autres méthodes liées au registre, consultez Registres.

Configuration requise

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

Voir aussi