IDebugRegisters::SetValue-Methode (dbgeng.h)

Artikel
02/23/2024

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

Weitere Informationen