ExtRemoteData::ReadBuffer-Methode (engextcpp.hpp)
Die ReadBuffer-Methode liest Daten aus dem Speicher des Ziels. Die Daten befinden sich am Anfang des Bereichs, der durch das ExtRemoteData-Objekt dargestellt wird. Die Größe der Daten kann jedoch unterschiedlich sein.
Syntax
ULONG ReadBuffer(
[out] PVOID Buffer,
[in] ULONG Bytes,
[in] bool MustReadAll
);
Parameter
[out] Buffer
Zeiger, der die vom Ziel gelesenen Daten empfängt.
[in] Bytes
Gibt die Anzahl der zu lesenden Bytes an. Der Puffer muss mindestens diese Größe aufweisen.
[in] MustReadAll
Gibt an, was geschieht, wenn die Debugger-Engine nicht alle Daten vom Ziel lesen kann. Wenn MustReadAll ist true
und die Debugger-Engine Bytes nicht vom Ziel lesen kann, wird eine ExtRemoteException ausgelöst. Wenn MustReadAll den Wert aufweist false
, wird keine Ausnahme ausgelöst, wenn die Engine die angeforderte Anzahl von Bytes vom Ziel nicht lesen kann.
Rückgabewert
ReadBuffer gibt die Anzahl der Bytes zurück, die vom Ziel gelesen und in den Pufferpuffer kopiert wurden. Wenn MustReadAll auf festgelegt ist true
, wird der Wert von Bytes zurückgegeben (es sei denn, es wird eine Ausnahme ausgelöst).
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | engextcpp.hpp (include Engextcpp.hpp) |