IDebugRegisters2::GetValues-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetValues-Methode ruft den Wert mehrerer Register des Ziels ab.

Syntax

HRESULT GetValues(
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [out]          PDEBUG_VALUE Values
);

Parameter

[in] Count

Gibt die Anzahl der Register an, deren Werte angefordert werden.

[in, optional] Indices

Gibt ein Array an, das die Indizes der Register enthält, aus denen die Werte abgerufen 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 nacheinander ab diesem Index gelesen. Andernfalls wird es ignoriert.

[out] Values

Empfängt die Werte der Register. 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 eines der Register konnte nicht zugegriffen werden.
E_INVALIDARG	Der Wert des Indexes eines der Register ist größer als die Anzahl der Register auf dem Zielcomputer. Es könnten Teilergebnisse erzielt worden sein; Die Register, die nicht gelesen werden konnten, weisen den Typ DEBUG_VALUE_INVALID auf.

Hinweise

GetValues ruft den Wert mehrerer Register des Ziels ab.

Wenn der Rückgabewert nicht S_OK ist, wurden einige der Register möglicherweise noch gelesen. Wenn auf das Ziel nicht zugegriffen werden kann, ist der Rückgabetyp E_UNEXPECTED und Werte unverändert. Andernfalls enthalten Werte Teilergebnisse, und die Register, die nicht gelesen werden konnten, weisen den Typ DEBUG_VALUE_INVALID auf. Mehrdeutigkeit im Fall des Rückgabewerts E_UNEXPECTED kann vermieden werden, indem der Arbeitsspeicher von Values vor dem Aufrufen dieser Methode auf 0 festgelegt wird.

Verwenden Sie stattdessen die GetValue-Methode , um den Wert eines einzelnen Registers zu erhalten.

Die GetValues2-Methode 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