Fungsi SHStrDupW (shlwapi.h)
Membuat salinan string dalam memori yang baru dialokasikan.
Sintaks
LWSTDAPI SHStrDupW(
[in] LPCWSTR psz,
[out] LPWSTR *ppwsz
);
Parameter
[in] psz
Jenis: LPCTSTR
Penunjuk ke string yang dihentikan null untuk disalin.
[out] ppwsz
Jenis: LPTSTR*
Penunjuk ke string Unicode yang dialokasikan yang berisi hasilnya. SHStrDup mengalokasikan memori untuk string ini dengan CoTaskMemAlloc. Anda harus membebaskan string dengan CoTaskMemFree ketika tidak lagi diperlukan.
Dalam kasus kegagalan, nilai ini adalah NULL.
Nilai kembali
Jenis: HRESULT
Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM sebaliknya.
Keterangan
Fungsi ini akan mengambil string Unicode atau ANSI sebagai input, tetapi string yang disalin selalu Unicode.
Fungsi ini menggunakan CoTaskMemAlloc untuk mengalokasikan memori untuk string yang disalin. Anda harus membebaskan memori ini dengan CoTaskMemFree ketika tidak lagi diperlukan.
Catatan
Header shlwapi.h mendefinisikan SHStrDup sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlwapi.h |
| Pustaka | Shlwapi.lib |
| DLL | Shlwapi.dll (versi 5.0 atau yang lebih baru) |