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

Статья
02/06/2025

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

Синтаксис

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

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

[in] BufferSize

Задает размер буфера в символах.

[out, optional] StringBytes

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

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

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

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

Замечания

Модуль будет считывать до MaxBytes из целевого объекта, искать конечный элемент NULL. Если строка содержит более символов BufferSize, строка будет усечена, чтобы она соответствовала буферу.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h, Winnls.h)

См. также

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide

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