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

Статья
02/06/2025

Метод ReadUnicodeStringVirtualWide считывает строку Юникода null из целевого объекта.

Синтаксис

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	Метод был успешным. Однако буферный недостаточно велик, чтобы сохранить строку, и строка была усечена, чтобы она соответствовала буферу. Усеченная строка завершается null, если буфера имеет пробел по крайней мере для одного символа.
E_INVALIDARG	После чтения MaxBytes из целевого объекта не найден конечный термин null.

Метод был успешным.

Замечания

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

Требования

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

См. также

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual

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