Metodo IDebugDataSpaces4::ReadUnicodeStringVirtualWide (dbgeng.h)

Articolo
02/06/2025

Il metodo ReadUnicodeStringVirtualWide legge una stringa Unicode con terminazione Null 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, 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

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

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

Il metodo ha avuto esito positivo.

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

Condividi tramite