Fungsi ResUtilSetBinaryValue (resapi.h)

Mengatur nilai biner dalam database kluster.

Sintaks

DWORD ResUtilSetBinaryValue(
  [in]                HKEY         hkeyClusterKey,
  [in]                LPCWSTR      pszValueName,
  [in]                const LPBYTE pbNewValue,
  [in]                DWORD        cbNewValueSize,
  [in, out, optional] LPBYTE       *ppbOutValue,
  [in, out]           LPDWORD      pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Kunci yang mengidentifikasi lokasi nilai biner dalam database kluster.

[in] pszValueName

String Unicode yang dihentikan null yang berisi nama nilai yang akan diperbarui.

[in] pbNewValue

Arahkan ke nilai biner baru.

[in] cbNewValueSize

Ukuran nilai biner baru.

[in, out, optional] ppbOutValue

Alamat penunjuk ke nilai biner baru.

[in, out] pcbOutValueSize

Penunjuk ke DWORD di mana ukuran dalam byte nilai yang ditujukkan oleh ppbOutValue dikembalikan.

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 selama alokasi memori.

Keterangan

Fungsi utilitas ResUtilSetBinaryValue mengalokasikan memori untuk penunjuk ppbOutValue menggunakan fungsi LocalAlloc, memanggil fungsi CLUSTER APIClusterRegSetValue, lalu menyalin nilai baru ke buffer ini. Jika penunjuk bukan NULL, ResUtilSetBinaryValue juga membatalkan alokasinya. Sebagai penelepon fungsi ini, Anda bertanggung jawab untuk membatalkan alokasi buffer menggunakan fungsi LocalFree.

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

• Tutup
• Offline
• Online
• Buka
• Hentikan

ResUtilSetBinaryValue 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

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue