IDebugRegisters2::SetValues-Methode (dbgeng.h)

Artikel
02/06/2025

Mit der SetValues- -Methode wird der Wert mehrerer des Zielsregistriert.

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-ist, werden die Register fortlaufend beginnend mit 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 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 mindestens ein 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.

Bemerkungen

Das Modul macht es am besten, die Werte in Werte in den Typ der Register zu vererzen; 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 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 geändert, das es enthält.

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

Die Methode SetValues2 die gleiche Aufgabe wie diese Methode ausführt, 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
Header-	dbgeng.h (include DbgEng.h)

Siehe auch

Freigeben über