IDebugRegisters2::GetValues2-Methode (dbgeng.h)

Artikel
02/06/2025

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

Syntax

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

Parameter

[in] Source

Gibt die zu abfragende Registerquelle an.

Die möglichen Werte sind in der folgenden Tabelle aufgeführt.

Wert	Quelle registrieren
DEBUG_REGSRC_DEBUGGEE	Abrufen von Registrierungsinformationen aus dem Ziel.
DEBUG_REGSRC_EXPLICIT	Abrufen von Registrierungsinformationen aus dem aktuellen expliziten Registrieren des Kontexts.
DEBUG_REGSRC_FRAME	Abrufen von Registrierungsinformationen aus dem Registerkontext des aktuellen Bereichs. Hinweis Stack-Abspannen garantiert keine genaue Aktualisierung des Registerkontexts, sodass der Registerkontext des Bereichsrahmens in allen Fällen möglicherweise nicht korrekt ist.

[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_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

Wenn der Rückgabewert nicht S_OK ist, wurden einige der Register möglicherweise noch gelesen. Wenn auf das Ziel nicht zugegriffen werden konnte, 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.

Die Methode GetValues führt dieselbe Aufgabe wie diese Methode aus, verwendet aber immer das Ziel als 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

GetValue-

GetValues-

IDebugRegisters2

Freigeben über