Fungsi ResUtilSetExpandSzValue (resapi.h)

Mengatur nilai string yang dapat diperluas dalam database kluster. Jenis PRESUTIL_SET_EXPAND_SZ_VALUE mendefinisikan penunjuk ke fungsi ini.

Sintaks

DWORD ResUtilSetExpandSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in, out, optional] LPWSTR  *ppszOutString
);

Parameter

[in] hkeyClusterKey

Kunci yang mengidentifikasi lokasi nilai string yang dapat diperluas dalam database kluster.

[in] pszValueName

untai (karakter) Unicode null-terminated yang berisi nama nilai yang akan diperbarui.

[in] pszNewValue

Penunjuk ke nilai string baru yang dapat diperluas.

[in, out, optional] ppszOutString

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

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 ResUtilSetExpandSzValue mengalokasikan memori untuk nilai baru dan memanggil fungsi CLUSTER APIClusterRegSetValue.

Nilai string yang dapat diperluas berisi data yang mewakili string Unicode yang dihentikan null yang berisi referensi yang tidak terluaskan ke variabel lingkungan seperti "%SystemRoot%".

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

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

• Tutup
• Offline
• Online
• Buka
• Hentikan

ResUtilSetExpandSzValue 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

ResUtilSetMultiSzValue

ResUtilSetSzValue