IDebugRegisters::SetValue-Methode (dbgeng.h)

Artikel
02/06/2025

Mit der SetValue--Methode wird der Wert eines der des Zielsregistriert.

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 der möglichen 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.

Bemerkungen

Der Motor macht es am besten, den Wert von Wert in den Typ des Registers zu ernennen; Diese Koersion ist identisch mit der von CoerceValuedurchgeführten. Wenn der Wert größer ist als das, was das Register enthalten kann, werden die am wenigsten signifikanten Bits verworfen. Gleitkomma- und Ganzzahlkonvertierungen werden bei Bedarf ebenfalls ausgeführt.

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

Um die Werte mehrerer Register festzulegen, verwenden Sie stattdessen die SetValues Methode.

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include DbgEng.h)

Siehe auch

Freigeben über