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

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

  • Статья

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

Синтаксис

HRESULT ReadMultiByteStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [out, optional] PWSTR   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
 Метод не был успешным.
E_INVALIDARG
 Признак конца null не найден после считывания MaxBytes из целевого объекта.
 

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

Комментарии

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

Обратите внимание, что даже если возвращается S_OK, возможно, буфер был недостаточно велик для хранения строки. В этом случае строка усекается, чтобы поместиться в буфер. Усеченная строка завершается значением NULL, если в буфере есть пробел хотя бы для одного символа. После возврата вызова проверка, чтобы узнать, больше ли значение *StringBytes, чем BufferSize.

Требования

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

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

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide