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

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.

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

 

[in] BufferChars

Specifica le dimensioni, in caratteri, del buffer buffer buffer.

[in] MaxChars

Specifica il numero massimo di caratteri da leggere dalla destinazione.

[in] MustFit

Specifica cosa accade se la stringa è maggiore di BufferChars caratteri. Se MustFit è true e la stringa è maggiore di caratteri BufferChars, verrà generata un'eccezione extRemoteException. Se MustFit è false e la stringa è maggiore di BufferChars caratteri, la stringa verrà troncata e terminata con null per adattarsi all'interno del buffer buffer Buffer.

NeedChars

Valore restituito

GetString restituisce la stringa con terminazione Null letta dalla destinazione. Si tratta di buffer.

Osservazioni

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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	engextcpp.hpp (include Engextcpp.hpp)

Vedere anche

ExtRemoteData

ExtRemoteData::ReadBuffer