Metode IDebugDataSpaces4::ReadUnicodeStringVirtualWide (dbgeng.h)

  • Artikel

Metode ReadUnicodeStringVirtualWide membaca string Unicode yang dihentikan null dari target.

Sintaks

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

[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

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

Menampilkan kode Deskripsi
S_OK
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 berhasil.

Keterangan

Mesin akan membaca hingga MaxBytes dari target, 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