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

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

  • Статья

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

Синтаксис

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

Получает строку из целевого объекта. Если параметр 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)

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

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual