Метод ExtRemoteData::GetString(PWSTR,ULONG,ULONG,bool,PULONG) (engextcpp.hpp)

Метод GetString считывает строку, завершающуюся значением NULL, из памяти целевого объекта. Строка находится в начале региона, представленного объектом ExtRemoteData.

Синтаксис

PWSTR GetString(
  [out] PWSTR  Buffer,
  [in]  ULONG  BufferChars,
  [in]  ULONG  MaxChars,
  [in]  bool   MustFit,
        PULONG NeedChars
);

Параметры

[out] Buffer

Получает строку, завершаемую значением NULL, из целевого объекта. Тип буфера должен совпадать с типом строки в целевом объекте. Если строка является строкой Юникода, тип буфера должен быть PWSTR. Если строка является многобайтовой строкой, тип буфера должен быть PSTR.

[in] BufferChars

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

[in] MaxChars

Указывает максимальное количество символов для чтения из целевого объекта.

[in] MustFit

Указывает, что происходит, если строка больше символов буферных диаграмм. Если MustFittrue и строка больше символов BufferChars, будет создано ExtRemoteException. Если MustFitfalse и строка больше символов bufferChars, строка будет усечена и завершена значение NULL, чтобы поместиться в буфер буфер.

NeedChars

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

GetString возвращает строку, завершающую значение NULL, считываемую из целевого объекта. Это буфер.

Замечания

Этот метод можно использовать только в том случае, если регион, представленный объектом ExtRemoteData, находится в виртуальной памяти. Он не будет работать, если регион указывает физическую память.

Требования

См. также

ExtRemoteData

ExtRemoteData::ReadBuffer