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

从目标接收字符串。 如果 缓冲区NULL,则不会返回此信息。

注意 返回的字符串之后缓冲区的其余部分可能会被此方法覆盖。
 

[in] BufferSize

指定 缓冲区 缓冲区的大小(以字符为单位)。

[out, optional] StringBytes

接收字符串的大小(以字节为单位)。 如果 StringBytesNULL,则不会返回此信息。

返回值

此方法还可以返回错误值。 有关详细信息,请参阅 返回值

返回代码 描述
S_OK
S_FALSE
该方法成功。 但是,缓冲区 不够大,无法容纳字符串,字符串被截断,以适应 Buffer。 如果 Buffer 至少有一个字符的空间,则截断字符串为 null 终止。
E_INVALIDARG
从目标读取 MaxBytes 后找不到 null 终止符。
 

该方法成功。

言论

引擎将从目标读取最多 maxBytes,查找 null 终止符。 如果字符串具有多个 BufferSize 字符,则字符串将被截断,以适应 Buffer

要求

要求 价值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual