Fungsi UtilStringCopyWithAlloc

Fungsi UtilStringCopyWithAlloc mengalokasikan dan menyalin string sumber.

Sintaks

HRESULT UtilStringCopyWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR Source
);

Parameter

Buffer [keluar]

Jenis: LPWSTR*

Lokasi tempat penunjuk ke memori yang dialokasikan disimpan. Ketika tidak lagi diperlukan, itu harus dirilis dengan CoTaskMemFree. Buffer ini selalu dihentikan null.

BufferMax [in]

Jenis: UINT

Jumlah maksimum karakter yang akan dibaca dari Sumber.

Sumber [in]

Jenis: LPCWSTR

String yang akan disalin.

Menampilkan nilai

Jenis: HRESULT

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_INVALIDARG	Satu atau beberapa parameter belum disediakan dengan benar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	Ndattributils.h

Lihat juga

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc