Fungsi WindowsCreateString (winstring.h)

Artikel
10/20/2023

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
S_OK	HSTRING berhasil dibuat.
E_INVALIDARG	string adalah NULL.
E_OUTOFMEMORY	Gagal mengalokasikan HSTRING baru.
E_POINTER	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

Lihat juga

WindowsCreateStringReference

WindowsDeleteString

Bagikan melalui