IDebugRegisters2 ::SetValue, méthode (dbgeng.h)
La méthode SetValue définit la valeur de l’un des registres 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 de retour
Cette liste ne contient pas toutes les erreurs qui peuvent se produire. Pour obtenir la liste des erreurs possibles, consultez valeurs HRESULT.
| Retourner le code | Description |
|---|---|
|
La méthode a réussi. |
|
La cible n’est pas accessible, ou le registre n’a pas pu être accessible. |
|
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 aux entiers sont également effectuées si nécessaire.
Lorsqu’une sous-inscription est modifiée, le registre contenant celui-ci 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 à l’inscription, consultez Registers.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include DbgEng.h) |