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

Статья
02/06/2025

Метод ReadMultiByteStringVirtual считывает строку, завершающую значение NULL, из целевого объекта.

Синтаксис

HRESULT ReadMultiByteStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PSTR    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

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