Поделиться через

Метод IDebugDataSpaces4::ReadUnicodeStringVirtual (dbgeng.h)

  • Статья

Метод ReadUnicodeStringVirtual считывает строку Юникода, завершающуюся null, из целевого объекта и преобразует ее в многобайтовую строку.

Синтаксис

HRESULT ReadUnicodeStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

Параметры

[in] Offset

Указывает расположение строки в виртуальном адресном пространстве процесса.

[in] MaxBytes

Указывает максимальное количество байтов для чтения из целевого объекта.

[in] CodePage

Указывает кодовую страницу, используемую для преобразования многобайтовой строки, считываемой из целевого объекта, в строку Юникода. Например, CP_ACP — кодовая страница ANSI.

[out, optional] Buffer

Получает строку из целевого объекта. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Указывает размер буфера в символах.

[out, optional] StringBytes

Получает размер строки в байтах в целевом объекте. Если stringBytes имеет значение NULL, эти сведения не возвращаются.

Возвращаемое значение

Код возврата Описание
S_OK
 Метод выполнен успешно.
S_FALSE
 Метод выполнен успешно. Однако буфер не был достаточно велик, чтобы вместить строку, и строка была усечена, чтобы поместиться в буфер. Усеченная строка завершается значением NULL, если в буфере есть пробел хотя бы для одного символа.
E_INVALIDARG
 Признак конца null не найден после считывания MaxBytes из целевого объекта.
 

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Комментарии

Подсистема будет считывать до MaxBytes из целевого объекта, в поисках признака конца null. Если строка содержит больше символов BufferSize , строка будет усечена, чтобы поместиться в буфер.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h, Winnls.h)

См. также раздел

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide