Fungsi ResUtilSetMultiSzValue (resapi.h)

Mengatur beberapa nilai string dalam database kluster. Jenis PRESUTIL_SET_MULTI_SZ_VALUE menentukan penunjuk ke fungsi ini.

Sintaks

DWORD ResUtilSetMultiSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in]                DWORD   cbNewValueSize,
  [out, optional]     LPWSTR  *ppszOutValue,
  [in, out, optional] LPDWORD pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Kunci yang mengidentifikasi lokasi beberapa nilai string dalam database kluster.

[in] pszValueName

Untai (karakter) Unicode yang dihentikan null yang berisi nama nilai yang akan diperbarui.

[in] pszNewValue

Arahkan ke beberapa nilai string baru.

[in] cbNewValueSize

Ukuran nilai baru.

[out, optional] ppszOutValue

Penunjuk ke penunjuk string yang menerima salinan nilai yang diperbarui. Jika digunakan, penelepon harus memanggil LocalFree pada *ppszOutValue.

[in, out, optional] pcbOutValueSize

Penunjuk yang menerima ukuran nilai baru.

Nilai kembali

Jika operasi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika operasi gagal, fungsi mengembalikan kode kesalahan sistem. Berikut ini adalah kemungkinan kode kesalahan.

Menampilkan kode	Deskripsi
ERROR_NOT_ENOUGH_MEMORY	Terjadi kesalahan saat mencoba mengalokasikan memori.

Keterangan

Fungsi utilitas ResUtilSetMultiSzValue mengalokasikan memori untuk nilai baru dan memanggil fungsi Cluster APIClusterRegSetValue.

Nilai beberapa string adalah string besar yang berisi string Unicode yang lebih kecil, berdekatan, dan dihentikan null dan diakhiri dengan karakter null tambahan setelah string terakhir.

Pastikan untuk memanggil LocalFree di *ppszOutValue untuk menghindari kebocoran memori.

Jangan panggil ResUtilSetMultiSzValue dari fungsi titik entri DLL sumber daya berikut:

• Tutup
• Offline
• Online
• Buka
• Hentikan

ResUtilSetMultiSzValue dapat dipanggil dengan aman dari fungsi titik entri DLL sumber daya lainnya atau dari utas pekerja. Untuk informasi selengkapnya, lihat Panggilan Fungsi untuk Dihindari di DLL Sumber Daya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Pusat Data Windows Server 2008 Enterprise, Windows Server 2008
Target Platform	Windows
Header	resapi.h
Pustaka	ResUtils.lib
DLL	ResUtils.dll

Lihat juga

ClusterRegSetValue

ResUtilSetBinaryValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetSzValue