Fungsi WindowsInspectString (winstring.h)

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

Syntax

HRESULT WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *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 WindowsInspectString .

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	IMAGE_FILE_MACHINE_AMD64 ditentukan untuk mesin, tetapi platform saat ini bukan Win64, atau mesin tidak IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386, atau IMAGE_FILE_MACHINE_ARM, atau targetHString bukan HSTRING yang terbentuk dengan benar.

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