Metodo IDebugDataSpaces4::ReadMultiByteStringVirtualWide (dbgeng.h)

Articolo
02/06/2025

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

Sintassi

HRESULT ReadMultiByteStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [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.

[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 non è riuscito.
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.

Si noti che anche se viene restituito S_OK, il buffer potrebbe non essere sufficientemente grande da archiviare la stringa. In questo caso la stringa viene troncata per adattarsi a Buffer. La stringa troncata viene terminata con null se buffer ha spazio per almeno un carattere. Al termine della chiamata, verificare se *StringBytes è maggiore di BufferSize.

Fabbisogno

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

Vedere anche

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide

Condividi tramite