Fungsi SHLocalStrDupA (shlwapi.h)

Artikel
20/11/2024

Membuat salinan string dalam memori yang baru dialokasikan.

Sintaksis

C++

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

Parameter

psz

Jenis: PCTSTR

Penunjuk ke string Unicode null-terminated yang akan disalin.

[out, optional] ppsz

Jenis: PTSTR*

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

Mengembalikan nilai

Jenis: HRESULT

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

Komentar

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

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h

Bagikan melalui