Fungsi UtilLoadStringWithAlloc

Fungsi UtilLoadStringWithAlloc mengalokasikan dan memuat string dari tabel sumber daya.

Sintaksis

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

Parameter-parameternya

uID [in]

Jenis: UINT

Pengidentifikasi string yang akan dimuat.

ppwzBuffer [out]

Jenis: LPWSTR*

Lokasi tempat string yang baru dialokasikan akan ditempatkan. String harus dibebaskan menggunakan CoTaskMemFree ketika tidak lagi diperlukan.

cchBufferMax [in]

Jenis: UINT

Jumlah maksimum karakter yang akan dimuat dari tabel sumber daya. Jika string sumber daya lebih panjang dari jumlah karakter yang ditentukan, string sumber daya dipotong dan dihentikan null.

Nota

Parameter ini mungkin tidak diatur ke nol.

Mengembalikan nilai

Jenis: HRESULT

Kemungkinan nilai pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Mengembalikan 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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Kepala Halaman	Ndattributils.h

Lihat juga

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree