Fungsi ORSetValue

Artikel
06/13/2023

Mengatur data untuk nilai kunci registri tertentu dalam sarang registri offline.

Sintaks

DWORD ORSetValue(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpValueName,
  _In_     DWORD  dwType,
  _In_opt_ const BYTE *lpData,
  _In_     DWORD  cbData
);

Parameter

Handel [in]

Handel ke kunci registri terbuka di sarang registri offline.

lpValueName [dalam, opsional]

Nama nilai yang akan ditetapkan. Jika nilai dengan nama ini belum ada di kunci, fungsi menambahkannya ke kunci.

Jika lpValueName adalah NULL atau string kosong, "", fungsi mengatur jenis dan data untuk kunci yang tidak bernama atau nilai default.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

Kunci registri tidak memiliki nilai default, tetapi dapat memiliki satu nilai yang tidak disebutkan namanya, yang bisa dari jenis apa pun.

dwType [in]

Jenis data yang diacak oleh parameter lpData . Untuk daftar jenis yang mungkin, lihat Jenis Nilai Registri.

lpData [in, opsional]

Data yang akan disimpan.

Untuk jenis berbasis string, seperti REG_SZ, string harus dihentikan null. Untuk jenis data REG_MULTI_SZ, string harus dihentikan dengan dua karakter null.

cbData [in]

Ukuran informasi yang ditujukkan oleh parameter lpData , dalam byte. Jika data berjenis REG_SZ, REG_EXPAND_SZ, atau REG_MULTI_SZ, cbData harus menyertakan ukuran karakter atau karakter null yang mengakhiri.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Keterangan

Ukuran nilai dibatasi oleh memori yang tersedia. Nilai panjang (lebih dari 2048 byte) harus disimpan sebagai file dengan nama file yang disimpan dalam registri. Ini membantu registri berkinerja efisien. Elemen aplikasi seperti ikon, bitmap, dan file yang dapat dieksekusi harus disimpan sebagai file dan tidak ditempatkan di registri.

Persyaratan

Persyaratan	Nilai
Redistribusi	Pustaka Windows Offline Registry versi 1.0 atau yang lebih baru
Header	Offreg.h
DLL	Offreg.dll

Lihat juga

ORCreateKey
OROpenKey

Bagikan melalui