DkmILMemoryStringRead Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
A request to read a null-terminated string from the target process. The address to read from is popped off the DkmIL stack and must have a size of 4 if the debuggee is 32-bit, or 8 if the debuggee is 64-bit. The bytes that are read from memory are pushed onto the stack. This will include the null-terminator if this value is read. The null-terminator will be missing when DkmReadMemoryFlags.AllowPartialRead is true, and either the MaxCharacters is hit, or unreadable memory is hit before the null terminator.
public ref class DkmILMemoryStringRead : Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILInstruction
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmILMemoryStringRead : Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILInstruction
[Windows::Foundation::Metadata::WebHostHidden]
class DkmILMemoryStringRead : Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILInstruction
[System.Runtime.InteropServices.Guid("a64d7c04-4e5a-4a75-936c-5eeeb7121f65")]
public class DkmILMemoryStringRead : Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILInstruction
[<System.Runtime.InteropServices.Guid("a64d7c04-4e5a-4a75-936c-5eeeb7121f65")>]
type DkmILMemoryStringRead = class
inherit DkmILInstruction
Public Class DkmILMemoryStringRead
Inherits DkmILInstruction
- Inheritance
- Attributes
Properties
CharacterSize |
Number of bytes in each character. This should be set to 1 (ANSI/UTF-8), 2 (UTF-16) or 4 (UTF-32). |
Flags |
Flags controlling the behavior of DkmProcess.ReadMemory and DkmProcess.ReadMemoryString. |
MaxCharacters |
The maximum number of characters to read from the target process. When DkmReadMemoryFlags.AllowPartialRead is false, the request will fail if a null terminator isn't found within this range with DkmILFailureReason.StringTooLong. |
TagValue |
DkmILInstruction is an abstract base class. This enum indicates which derived class this object is an instance of. (Inherited from DkmILInstruction) |
UniqueId |
Uniquely identifies the DkmILInstruction object. Used as a hash-table key to allow for quickly matching up DkmIL instructions with their matching values. (Inherited from DkmILInstruction) |
Methods
Create(DkmReadMemoryFlags, UInt16, Int32) |
Create a new DkmILMemoryStringRead object instance. |