IDebugRegisters::SetValues-Methode (dbgeng.h)

Artikel
02/23/2024

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
S_OK	Die Methode war erfolgreich.
E_UNEXPECTED	Auf das Ziel kann nicht zugegriffen werden, oder auf ein oder mehrere Register konnte nicht zugegriffen werden.
E_INVALIDARG	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)

Weitere Informationen