Fungsi WindowsInspectString2 (winstring.h)

Menyediakan cara untuk debugger menampilkan nilai Windows Runtime HSTRING di ruang alamat lain, dari jarak jauh, atau dari cadangan.

Syntax

HRESULT WindowsInspectString2(
  UINT64                     targetHString,
  USHORT                     machine,
  PINSPECT_HSTRING_CALLBACK2 callback,
  void                       *context,
  UINT32                     *length,
  UINT64                     *targetStringAddress
);

Parameter-parameternya

targetHString

[di]

HSTRING untuk diperiksa.

machine

Format ruang alamat target. Nilai yang valid IMAGE_FILE_MACHINE_AMD64 untuk Win64, IMAGE_FILE_MACHINE_I386 untuk Win32, atau IMAGE_FILE_MACHINE_ARM untuk ARM 32-bit.

callback

[di]

Fungsi panggilan balik untuk membaca buffer string dari ruang alamat target. Fungsi ini dipanggil sebelum parameter panjang dan targetStringAddress dihitung oleh fungsi WindowsInspectString2 .

context

[dalam, opsional]

Data konteks kustom diteruskan ke panggilan balik.

length

[out]

Panjang string di ruang alamat target, jika panggilan ke panggilan balik berhasil; jika tidak, 0.

targetStringAddress

[out]

Alamat target PCWSTR mentah, jika panggilan ke panggilan balik berhasil; jika tidak, NULL.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode	Description
E_INVALIDARG	Nilai komputer tidak IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386, atau IMAGE_FILE_MACHINE_ARM atau targetHString bukan HSTRING yang terbentuk dengan benar.

Komentar

Fungsi WindowsInspectString meneruskan penunjuk input dan output sebagai nilai berukuran pointer asli. Jika platform saat ini adalah Win32, fungsi tersebut mengembalikan kesalahan untuk proses yang win64.

WindowsInspectString2 memungkinkan penelusuran kesalahan lintas arsitektur dengan mengizinkan nilai hingga 64-bit saat dipanggil dari aplikasi Win32 dan Win64.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Platform Target	Windows
Header	winstring.h
Library	RuntimeObject.lib
DLL	ComBase.dll

Lihat juga

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString