IDebugRegisters2::GetValues-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetValues--Methode ruft den Wert mehrerer des Zielsab.

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 fortlaufend ab diesem Index gelesen. Andernfalls wird sie 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 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 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. Möglicherweise wurden Teilergebnisse erzielt; diese Register, die nicht gelesen werden konnten, weisen den Typ DEBUG_VALUE_INVALID auf.

Bemerkungen

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, DEBUG_VALUE_INVALID. Mehrdeutigkeit im Fall des Rückgabewerts E_UNEXPECTED kann vermieden werden, indem der Speicher von Values auf Null festgelegt wird, bevor diese Methode aufgerufen wird.

Um den Wert nur eines einzelnen Registers zu erhalten, verwenden Sie stattdessen die GetValue--Methode.

Die Methode GetValues2 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
Header-	dbgeng.h (include DbgEng.h)

Siehe auch

Freigeben über