Método ExtRemoteData::GetString(PSTR,ULONG,ULONG,bool,PULONG) (engextcpp.hpp)

Artículo
02/26/2024

El método GetString lee una cadena terminada en null de la memoria del destino. La cadena se encuentra al principio de la región representada por el objeto ExtRemoteData .

Sintaxis

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

Parámetros

[out] Buffer

Recibe la cadena terminada en null que se lee del destino. El tipo de búfer debe ser el mismo que el tipo de la cadena en el destino. Si la cadena es una cadena Unicode, el tipo de búfer debe ser PWSTR. Si la cadena es una cadena multibyte, el tipo de Buffer debe ser PSTR.

Tenga en cuenta el resto del búfer de búfer , después de la cadena, que este método puede sobrescribir.

[in] BufferChars

Especifica el tamaño, en caracteres, del búfer de búfer .

[in] MaxChars

Especifica el número máximo de caracteres que se van a leer del destino.

[in] MustFit

Especifica lo que sucede si la cadena es mayor que los caracteres BufferChars . Si MustFit es true y la cadena es mayor que los caracteres BufferChars , se producirá una excepción ExtRemoteException . Si MustFit es false y la cadena es mayor que los caracteres BufferChars , la cadena se truncará y finalizará en null para caber dentro del búfer de búfer.

NeedChars

Valor devuelto

GetString devuelve la cadena terminada en null que se leyó desde el destino. Esto es Buffer.

Comentarios

Este método solo se puede usar si la región representada por el objeto ExtRemoteData está en memoria virtual. No funcionará si la región especifica memoria física.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	engextcpp.hpp (incluya Engextcpp.hpp)

Consulte también

ExtRemoteData

ExtRemoteData::ReadBuffer

Share via