Fungsi SHLocalStrDupA (shlwapi.h)

Artikel
03/04/2024

Membuat salinan string dalam memori yang baru dialokasikan.

Sintaks

HRESULT SHLocalStrDupA(
                  PCSTR psz,
  [out, optional] PSTR  *ppsz
);

Parameter

psz

Jenis: PCTSTR

Penunjuk ke string Unicode yang dihentikan null untuk disalin.

[out, optional] ppsz

Jenis: PTSTR*

Alamat penunjuk ke string yang dialokasikan yang, ketika fungsi ini berhasil kembali, menerima hasilnya. SHLocalStrDup mengalokasikan memori untuk string ini dengan LocalAlloc. Anda harus membebaskan string dengan LocalFree saat tidak lagi diperlukan.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Catatan

Header shlwapi.h mendefinisikan SHLocalStrDup 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h

Bagikan melalui