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

El método GetString lee una cadena terminada en null de la memoria del destino. La cadena se encuentra en el 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 desde el 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 buffer debe ser PWSTR. Si la cadena es una cadena multibyte, el tipo de buffer debe ser PSTR.

[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 bufferChars caracteres. Si mustFit es true y la cadena es mayor que caracteres de BufferChars, se producirá un ExtRemoteException. Si MustFit es false y la cadena es mayor que 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ó del destino. Se trata de Búfer.

Observaciones

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 la memoria física.

Requisitos

Consulte también

ExtRemoteData

ExtRemoteData::ReadBuffer