Fungsi ResUtilSetPrivatePropertyList (resapi.h)

Mengatur properti privatobjek kluster.

Sintaks

DWORD ResUtilSetPrivatePropertyList(
  [in] HKEY        hkeyClusterKey,
  [in] const PVOID pInPropertyList,
  [in] DWORD       cbInPropertyListSize
);

Parameter

[in] hkeyClusterKey

Kunci database kluster mengidentifikasi lokasi properti yang akan diatur.

[in] pInPropertyList

Penunjuk ke buffer input yang berisi daftar properti dengan nama dan nilai properti yang akan diatur.

[in] cbInPropertyListSize

Penunjuk ke ukuran dalam byte buffer input yang diacu oleh pInPropertyList.

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_BAD_ARGUMENTS	Satu atau beberapa parameter input tidak valid.
ERROR_INVALID_DATA	Ada masalah dengan panjang data properti.
ERROR_INSUFFICIENT_BUFFER	Buffer input yang diacu oleh pInPropertyList adalah NULL.
ERROR_INVALID_PARAMETER	Sintaks nama properti tidak valid.

Keterangan

Properti yang diatur dalam fungsi utilitas ResUtilSetPrivatePropertyList ditempatkan di bagian database kluster di bawah kunci yang ditentukan untuk objek persis seperti yang ditentukan oleh nama dalam daftar properti. Jika nama properti berisi karakter garis miring terbalik (\), setiap string yang mendahului karakter garis miring terbalik ditafsirkan sebagai nama subkunci, dan string terakhir setelah karakter garis miring terbalik terakhir ditafsirkan sebagai nama nilai.

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

• Tutup
• Offline
• Online
• Buka
• Hentikan

ResUtilSetPrivatePropertyList 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

ResUtilVerifyPrivatePropertyList