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

Articolo
03/10/2023

Il metodo GetString legge una stringa con terminazione Null dalla memoria della destinazione. La stringa si trova all'inizio dell'area rappresentata dall'oggetto ExtRemoteData .

Sintassi

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

Parametri

[out] Buffer

Riceve la stringa con terminazione Null letta dalla destinazione. Il tipo di buffer deve essere uguale al tipo della stringa nella destinazione. Se la stringa è una stringa Unicode, il tipo di Buffer deve essere PWSTR. Se la stringa è una stringa multibyte, il tipo di Buffer deve essere PSTR.

Si noti il resto del buffer buffer , dopo la stringa, può essere sovrascritto da questo metodo.

[in] BufferChars

Specifica le dimensioni, in caratteri, del buffer buffer .

[in] MaxChars

Specifica il numero massimo di caratteri da leggere dalla destinazione.

[in] MustFit

Specifica cosa accade se la stringa è maggiore dei caratteri BufferChars . Se MustFit è true e la stringa è maggiore dei caratteri BufferChars , verrà generata un'eccezione ExtRemoteException . Se MustFit è false e la stringa è maggiore dei caratteri BufferChars , la stringa verrà troncata e terminata null per adattarsi al buffer buffer .

NeedChars

Valore restituito

GetString restituisce la stringa con terminazione Null che è stata letta dalla destinazione. Questo è Buffer.

Commenti

Questo metodo può essere utilizzato solo se l'area rappresentata dall'oggetto ExtRemoteData è in memoria virtuale. Non funzionerà se l'area specifica la memoria fisica.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	engextcpp.hpp (include Engextcpp.hpp)

Vedi anche

ExtRemoteData

ExtRemoteData::ReadBuffer

Condividi tramite