IDebugDataSpaces4::ReadMultiByteStringVirtual method (dbgeng.h)

Artikel
02/26/2024

Metode ReadMultiByteStringVirtual membaca string multibyte yang dihentikan null dari target.

Sintaks

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

[out, optional] Buffer

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

Catatan Sisa buffer, mengikuti string yang dikembalikan, mungkin ditimpa oleh metode ini.

[in] BufferSize

Menentukan ukuran, dalam karakter, dari buffer Buffer .

[out, optional] StringBytes

Menerima ukuran, dalam byte, dari string. Jika StringBytesNULL, informasi ini tidak dikembalikan.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Metode berhasil. Namun Buffer tidak cukup besar untuk menahan string dan string dipotong agar pas di Buffer. String yang dipotong dihentikan null jika Buffer memiliki spasi untuk setidaknya satu karakter.
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 yang mencari terminator null. Jika string memiliki lebih dari karakter BufferSize , string akan dipotong agar pas di Buffer.

Persyaratan

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

Lihat juga

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual