Fungsi WindowsCreateString (winstring.h)
Membuat HSTRING baru berdasarkan string sumber yang ditentukan.
Sintaks
HRESULT WindowsCreateString(
PCNZWCH sourceString,
UINT32 length,
HSTRING *string
);
Parameter
sourceString
Jenis: [in, opsional] LPCWSTR
String yang dihentikan null untuk digunakan sebagai sumber untuk HSTRING baru. Untuk membuat string baru, kosong, atau NULL , berikan NULL untuk sourceString dan 0 untuk panjangnya.
length
Jenis: [in] UINT32
Panjang sourceString, dalam karakter Unicode. Harus 0 jika sourceStringNULL.
string
Jenis: [out] HSTRING*
Penunjuk ke HSTRING yang baru dibuat, atau NULL jika terjadi kesalahan. Konten apa pun yang ada dalam string ditimpa. HSTRING adalah jenis handel standar.
Nilai kembali
Jenis: HRESULT
Fungsi ini dapat mengembalikan salah satu nilai ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
HSTRING berhasil dibuat. |
|
string adalah NULL. |
|
Gagal mengalokasikan HSTRING baru. |
|
sourceStringNULL dan panjangnya bukan nol. |
Keterangan
Gunakan fungsi WindowsCreateString untuk mengalokasikan HSTRING baru. Windows Runtime menyalin string ke buffer cadangan HSTRING baru dan mengelola masa pakai buffer dengan menggunakan jumlah referensi. Panggil fungsi WindowsCreateStringReference untuk membuat string fast-pass, yang menggunakan string yang ada tanpa menyalinnya.
Panggil fungsi WindowsDeleteString untuk membatalkan alokasi HSTRING. Setiap panggilan ke fungsi WindowsCreateString harus dicocokkan dengan panggilan ke WindowsDeleteString.
Untuk membuat string baru, kosong, atau NULL , berikan NULL untuk sourceString dan 0 untuk panjangnya.
Jika sourceString telah menyematkan karakter null, fungsi WindowsCreateString menyalin semua karakter ke karakter null yang mengakhiri.
Persyaratan
| Klien minimum yang didukung | Windows 8 [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2012 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | winstring.h |