Fungsi ResUtilGetBinaryValue (resapi.h)

Mengembalikan nilai biner dari database kluster.

Sintaks

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Kunci dalam database kluster yang mengidentifikasi lokasi nilai yang akan diambil.

[in] pszValueName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama nilai yang akan diambil.

[out, optional] ppbOutValue

Alamat penunjuk ke nilai yang diambil.

[out] pcbOutValueSize

Penunjuk ke DWORD di mana ukuran dalam byte buffer yang diacu 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 saat mengalokasikan memori untuk nilai tersebut.

Keterangan

Fungsi utilitas ResUtilGetBinaryValue mengurus alokasi memori yang diperlukan untuk nilai dan kemudian memanggil fungsi Cluster APIClusterRegQueryValue. Setelah selesai dengan memori yang dialokasikan, Anda harus memanggil fungsi LocalFree untuk merilisnya.

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

ClusterRegQueryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue

ResUtilGetSzValue