Fungsi SHStrDupA (shlwapi.h)

Artikel
11/20/2024

Membuat salinan string dalam memori yang baru dialokasikan.

Sintaksis

LWSTDAPI SHStrDupA(
  [in]  LPCSTR psz,
  [out] LPWSTR *ppwsz
);

Parameter

[in] psz

Jenis: LPCTSTR

Penunjuk ke string null-terminated yang akan 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.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM jika tidak.

Komentar

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.

Nota

Header shlwapi.h mendefinisikan SHStrDup sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Lihat juga

StrDup

Bagikan melalui