Condividi tramite

Metodo IDebugDataSpaces4::ReadUnicodeStringVirtual (dbgeng.h)

Il metodo ReadUnicodeStringVirtual legge una stringa Unicode con terminazione Null dalla destinazione e la converte in una stringa multibyte.

Sintassi

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

Parametri

[in] Offset

Specifica il percorso nello spazio indirizzi virtuale del processo della stringa.

[in] MaxBytes

Specifica il numero massimo di byte da leggere dalla destinazione.

[in] CodePage

Specifica la tabella codici da usare per convertire la stringa multibyte letta dalla destinazione in una stringa Unicode. Ad esempio, CP_ACP è la tabella codici ANSI.

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] StringBytes

Riceve le dimensioni, in byte, della stringa nella destinazione. 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, Winnls.h)

Vedere anche

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide