Metodo IDebugDataSpaces4::ReadMultiByteStringVirtual (dbgeng.h)

Il metodo ReadMultiByteStringVirtual legge una stringa multibyte con terminazione Null dalla destinazione.

Sintassi

HRESULT ReadMultiByteStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

Parametri

[in] Offset

Specifica la posizione della stringa nello spazio indirizzi virtuale del processo.

[in] MaxBytes

Specifica il numero massimo di byte da leggere dalla destinazione.

[out, optional] Buffer

Riceve la stringa dalla destinazione. Se buffer è null, queste informazioni non vengono restituite.

Nota Il resto del buffer, dopo la stringa restituita, potrebbe essere sovrascritto da questo metodo.

 

[in] BufferSize

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

[out, optional] StringBytes

Riceve le dimensioni, in byte, della stringa. Se stringBytes è null, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, buffer non era sufficientemente grande da contenere la stringa e la stringa è stata troncata per adattarsi a Buffer. La stringa troncata viene terminata con null se buffer ha spazio per almeno un carattere.
E_INVALIDARG	Non è stato trovato un carattere di terminazione Null dopo aver letto MaxBytes dalla destinazione.

 

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Osservazioni

Il motore leggerà fino a MaxBytes dalla destinazione cercando un terminatore Null. Se la stringa contiene più di caratteri bufferSize, la stringa verrà troncata per adattarsi a Buffer.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Vedere anche

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual