Metodo IDebugDataSpaces4::ReadMultiByteStringVirtual (dbgeng.h)

Articolo
02/23/2024

Il metodo ReadMultiByteStringVirtual legge una stringa con terminazione null, multibyte 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, seguendo la stringa restituita, potrebbe essere sovrascritto da questo metodo.

[in] BufferSize

Specifica le dimensioni, in caratteri , del 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 è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia buffer non è stato abbastanza grande per contenere la stringa e la stringa è stata troncata per adattarsi al buffer. La stringa troncata viene terminata con valore Null se Buffer ha spazio per almeno un carattere.
E_INVALIDARG	Non è stato trovato un terminatore null dopo la lettura di MaxBytes dalla destinazione.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

Il motore leggerà fino a MaxByte dalla destinazione che cerca un terminatore null. Se la stringa ha più di caratteri BufferSize , la stringa verrà troncata per adattarsi al buffer.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (includere Dbgeng.h)

Vedi anche

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual

Condividi tramite