Metode IDebugDataSpaces4::ReadMultiByteStringVirtualWide (dbgeng.h)

  • Artikel

Metode ReadMultiByteStringVirtualWide membaca string multibyte yang dihentikan null dari target dan mengonversinya menjadi Unicode.

Sintaks

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

Parameter

[in] Offset

Menentukan lokasi string di ruang alamat virtual proses.

[in] MaxBytes

Menentukan jumlah maksimum byte yang akan dibaca dari target.

[in] CodePage

Menentukan halaman kode yang akan digunakan untuk mengonversi string multibyte yang dibaca dari target menjadi string Unicode. Misalnya, CP_ACP adalah halaman kode ANSI.

[out, optional] Buffer

Menerima string dari target. Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferSize

Menentukan ukuran, dalam karakter, dari buffer Buffer .

[out, optional] StringBytes

Menerima ukuran, dalam byte, dari string dalam target. Jika StringBytesADALAH NULL, informasi ini tidak dikembalikan.

Nilai kembali

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
S_FALSE
 Metode ini tidak berhasil.
E_INVALIDARG
 Terminator null tidak ditemukan setelah membaca MaxBytes dari target.
 

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Keterangan

Mesin akan membaca hingga MaxBytes dari target, mencari terminator null. Jika string memiliki lebih dari karakter BufferSize , untai (karakter) akan dipotok agar pas di Buffer.

Perhatikan bahwa meskipun S_OK dikembalikan, buffer mungkin belum cukup besar untuk menyimpan string. Dalam hal ini string dipotok agar pas di Buffer. String yang dipoting dihentikan null jika Buffer memiliki ruang untuk setidaknya satu karakter. Setelah panggilan kembali, periksa untuk melihat apakah *StringBytes lebih besar dari BufferSize.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h, Winnls.h)

Lihat juga

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide