Metodo IDebugDataSpaces4::ReadUnicodeStringVirtualWide (dbgeng.h)

Articolo
08/07/2023

Il metodo ReadUnicodeStringVirtualWide legge una stringa con terminazione Null, Unicode dalla destinazione.

Sintassi

HRESULT ReadUnicodeStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PWSTR   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

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

Codice restituito	Descrizione
S_OK
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.

Il metodo è stato eseguito correttamente.

Commenti

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