Fungsi WindowsDuplicateString (winstring.h)

Artikel
03/09/2024

Membuat salinan string yang ditentukan.

Sintaks

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Parameter

string

Jenis: [in] HSTRING

String yang akan disalin.

newString

Jenis: [out] HSTRING*

Salinan string.

Mengembalikan nilai

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	HSTRING berhasil disalin.
E_INVALIDARG	newString adalah NULL.
E_OUTOFMEMORY	Gagal mengalokasikan HSTRING baru.

Keterangan

Gunakan fungsi WindowsDuplicateString untuk menyalin HSTRING. Jika string dibuat dengan memanggil fungsi WindowsCreateString , jumlah referensi buffer backing akan bertambah. Jika string dibuat dengan memanggil fungsi WindowsCreateStringReference , Windows Runtime menyalin string sumbernya ke buffer baru dan memulai jumlah referensi, yang berarti bahwa newString bukan string yang cepat dilewatkan.

Setiap panggilan ke fungsi WindowsDuplicateString harus dicocokkan dengan panggilan yang sesuai ke WindowsDeleteString.

Persyaratan

Persyaratan	Nilai
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

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString

Bagikan melalui