HSTRING

Handel ke string Windows Runtime.

typedef HSTRING__* HSTRING;

Keterangan

Gunakan HSTRING untuk mewakili string yang tidak dapat diubah di Windows Runtime.

JavaScript dan bahasa lain, seperti C#, dan Microsoft Visual Basic, dapat menggunakan string yang diwakili dengan menggunakan HSTRING. Tabel berikut ini memperlihatkan bagaimana HSTRING diwakili dalam bahasa lain.

Bahasa pemrograman	Representasi String
C++/WinRT	winrt::kelas hstring
Ekstensi komponen Visual C++ (C++/CX)	Platform::Kelas string
JavaScript	Objek string
.NET Framework	Kelas System.String

 

Handel HSTRING adalah jenis handel standar. Secara semantik, HSTRING yang berisi nilai NULL mewakili string kosong, yang terdiri dari karakter konten nol dan karakter NULL yang mengakhiri. Membuat string melalui WindowsCreateString dengan karakter nol akan menghasilkan nilai handel NULL. Saat memanggil WindowsGetStringRawBuffer dengan nilai NULL, penunjuk ke string kosong hanya diikuti oleh karakter penghentian NUL akan dikembalikan. Tidak ada nilai berbeda untuk mewakili HSTRING yang tidak diinisialisasi.

Panggil fungsi WindowsCreateString untuk membuat HSTRING baru, dan panggil fungsi WindowsDeleteString untuk merilis referensi ke memori string cadangan. Panggil fungsi WindowsCreateStringReference untuk membuat referensi string, yang juga disebut string fast-pass.

Salin HSTRING dengan memanggil fungsi WindowsDuplicateString .

Menggabungkan dua string dengan memanggil fungsi WindowsConcatString .

Akses memori string cadangan dengan memanggil fungsi WindowsGetStringRawBuffer .

HSTRING dapat menyimpan dan menggunakan karakter NUL yang disematkan. Gunakan fungsi WindowsStringHasEmbeddedNull untuk memeriksa karakter NUL yang disematkan sebelum menggunakan fungsi apa pun yang dapat menghasilkan hasil yang tidak terduga. Misalnya, sebagian besar fungsi Windows menggunakan LPCWSTR sebagai parameter input, dan mereka menghitung panjang string hanya sampai NUL pertama ditemukan.

String cadangan harus tetap tidak dapat diubah dan dihentikan null. Saat memanggil kode membuat referensi string dengan menggunakan fungsi WindowsCreateStringReference , memori yang berisi representasi string cadangan dimiliki oleh pemanggil. Windows Runtime bergantung pada konten string asli untuk tetap tidak berubah. Saat meneruskan referensi string ke Windows Runtime, pemanggil bertanggung jawab untuk memastikan bahwa konten string tidak berubah dan NUL dihentikan selama durasi panggilan. Windows Runtime merilis semua referensi ke referensi string saat panggilan kembali.

Ketika Anda menerima HSTRING sebagai parameter keluar, adalah praktik yang baik untuk mengatur handel ke NULL ketika Anda selesai dengannya.

Panggil fungsi WindowsPreallocateStringBuffer untuk mengalokasikan buffer string yang dapat diubah yang dapat Anda gunakan untuk membuat HSTRING yang tidak dapat diubah. Setelah selesai mengisi buffer, Anda memanggil fungsi WindowsPromoteStringBuffer untuk membuat HSTRING. Pola konstruksi dua fase ini memungkinkan fungsionalitas yang mirip dengan "pembangun string."

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Header	Hstring.h

Lihat juga

WindowsCreateString

WindowsDeleteString

WindowsDuplicateString

WindowsPreallocateStringBuffer