IDebugDataSpaces4::ReadUnicodeStringVirtualWide 方法 (dbgeng.h)
ReadUnicodeStringVirtualWide 方法从目标中读取以 null 结尾的 Unicode 字符串。
语法
HRESULT ReadUnicodeStringVirtualWide(
[in] ULONG64 Offset,
[in] ULONG MaxBytes,
[out, optional] PWSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG StringBytes
);
参数
[in] Offset
指定字符串在进程的虚拟地址空间中的位置。
[in] MaxBytes
指定要从目标读取的最大字节数。
[out, optional] Buffer
从目标接收字符串。 如果 Buffer 为 NULL,则不返回此信息。
注意 此方法可能会覆盖返回的字符串后面的缓冲区的其余部分。
[in] BufferSize
指定 缓冲区 的大小(以字符为单位)。
[out, optional] StringBytes
接收字符串的大小(以字节为单位)。 如果 StringBytes 为 NULL,则不返回此信息。
返回值
此方法还可以返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
|
|
方法成功。 但是 ,Buffer 不够大,无法容纳字符串,字符串被截断以适合 Buffer。 如果 Buffer 至少有一个字符的空间,则截断的字符串以 null 结尾。 |
|
从目标读取 MaxBytes 后找不到 null 终止符。 |
方法成功。
注解
引擎将从目标中读取最大 MaxBytes ,以查找 null 终止符。 如果字符串包含的字符数超过 BufferSize ,则字符串将被截断以适合 Buffer。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |