IDebugRegisters::SetValue-Methode (dbgeng.h)
Die SetValue-Methode legt den Wert eines der Register des Ziels fest.
Syntax
HRESULT SetValue(
[in] ULONG Register,
[in] PDEBUG_VALUE Value
);
Parameter
[in] Register
Gibt den Index des Registers an, dessen Wert festgelegt werden soll.
[in] Value
Gibt den Wert an, auf den das Register festgelegt werden soll. Eine Beschreibung dieses Parametertyps finden Sie unter DEBUG_VALUE .
Rückgabewert
Diese Liste enthält nicht alle fehler, die auftreten können. Eine Liste möglicher Fehler finden Sie unter HRESULT-Werte.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
|
Auf das Ziel kann nicht zugegriffen werden, oder auf das Register konnte nicht zugegriffen werden. |
|
Der Wert von Register ist größer als die Anzahl der Register auf dem Zielcomputer. |
Hinweise
Die Engine gibt ihr Bestes, um den Wert von Value in den Typ des Registers zu umwandeln. dieser Zwang entspricht der von CoerceValue ausgeführten. Wenn der Wert größer ist als der Wert, der im Register enthalten sein kann, werden die am wenigsten signifikanten Bits gelöscht. Bei Bedarf werden auch Gleitkomma- und Ganzzahlkonvertierungen ausgeführt.
Wenn ein Unterregister geändert wird, wird auch das Register, das es enthält, geändert.
Verwenden Sie zum Festlegen der Werte mehrerer Register stattdessen die SetValues-Methode .
Eine Übersicht über die IDebugRegisters-Schnittstelle und andere registerbezogene Methoden finden Sie unter Register.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (dbgEng.h einschließen) |