IDebugRegisters2::SetValues-Methode (dbgeng.h)

Artikel
08/07/2023

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 sie 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 möglicherweise auftretenden Fehler. 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 eines 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 integrieren; dieser Zwang ist identisch mit der von CoerceValue durchgeführten. Wenn der Wert größer als der Wert ist, 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 Register festgelegt.

Wenn ein Unterregister geändert wird, wird auch das Register, das es enthält, geändert.

Um den Wert nur eines einzelnen Registers festzulegen, verwenden Sie stattdessen die SetValue-Methode .

Die Methode SetValues2 führt dieselbe Aufgabe wie diese Methode aus, ermöglicht aber auch die Angabe der Registerquelle.

Eine Übersicht über die IDebugRegisters-Schnittstelle und andere registerbezogene Methoden finden Sie unter Registers.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich DbgEng.h)

Weitere Informationen

Freigeben über