IDebugRegisters::SetValues-Methode (dbgeng.h)
Die SetValues-Methode legt den Wert mehrerer Register des Ziels fest.
Syntax
HRESULT SetValues(
[in] ULONG Count,
[in, optional] PULONG Indices,
[in] ULONG Start,
[in] PDEBUG_VALUE Values
);
Parameter
[in] Count
Gibt die Anzahl der Register an, für die die Werte festgelegt werden sollen.
[in, optional] Indices
Gibt ein Array an, das die Indizes der Register enthält, für die die Werte festgelegt werden sollen. Die Anzahl der Elemente in diesem Array ist Count. Wenn IndizesNULL ist, wird stattdessen Start verwendet.
[in] Start
Wenn IndizesNULL sind, werden die Register nacheinander ab diesem Index festgelegt. Andernfalls wird es ignoriert.
[in] Values
Gibt das Array an, das Werte enthält, auf die die Register festgelegt werden sollen. Die Anzahl der Elemente, die dieses Array enthält, ist Count. 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 ein oder mehrere Register konnte nicht zugegriffen werden. |
|
Der Wert des Indexes eines oder mehrerer Register ist größer als die Anzahl der Register auf dem Zielcomputer. |
Hinweise
Die Engine tut ihr Bestes, um die Werte in Werte in den Typ der Register zu übernehmen; 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 der Rückgabewert nicht S_OK ist, wurden möglicherweise noch einige der Register festgelegt.
Wenn ein Unterregister geändert wird, wird auch das Register, das es enthält, geändert.
Verwenden Sie stattdessen die SetValue-Methode , um den Wert eines einzelnen Registers festzulegen.
Die Methode SetValues2 führt dieselbe Aufgabe wie diese Methode aus, lässt aber auch die Angabe der Registerquelle zu.
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) |