Fungsi UtilLoadStringWithAlloc

Artikel
06/13/2023

Fungsi UtilLoadStringWithAlloc mengalokasikan dan memuat string dari tabel sumber daya.

Sintaks

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

Parameter

uID [in]

Jenis: UINT

Pengidentifikasi string yang akan dimuat.

ppwzBuffer [out]

Jenis: LPWSTR*

Lokasi tempat string yang baru dialokasikan akan ditempatkan. String harus dikosongkan 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 tersebut dipotong dan dihentikan null.

Catatan

Parameter ini mungkin tidak diatur ke nol.

Nilai kembali

Jenis: HRESULT

Nilai yang mungkin 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

UtilStringCopyWithAlloc
UtilAssembleStringsWithAlloc
CoTaskMemFree

Bagikan melalui