Fungsi ORCreateKey

Membuat kunci registri yang ditentukan dalam sarang registri offline. Jika kunci sudah ada, fungsi akan membukanya.

Sintaks

DWORD ORCreateKey(
  _In_      ORHKEY               Handle,
  _In_      PCWSTR               lpSubKey,
  _In_opt_  PWSTR                lpClass,
  _In_opt_  DWORD                dwOptions,
  _In_opt_  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Out_     PORHKEY              phkResult,
  _Out_opt_ PDWORD               pdwDisposition
);

Parameter

Handel [in]

Handel ke kunci registri terbuka di sarang registri offline.

lpSubKey [in]

Penunjuk ke string Unicode yang berisi nama subkunci yang dibuka atau dibuat fungsi ini. Parameter lpSubKey harus menentukan subkunci kunci yang diidentifikasi oleh parameter Handle ; bisa sampai 32 tingkat jauh di pohon registri. Untuk informasi selengkapnya tentang nama kunci, lihat Struktur Registri.

Parameter ini tidak boleh NULL.

Nama kunci tidak peka huruf besar/kecil.

lpClass [in, opsional]

Kelas (jenis objek) dari kunci ini. Parameter ini dapat diabaikan. Parameter ini bisa NULL.

dwOptions [in, opsional]

Parameter ini bisa 0 atau salah satu nilai berikut.

Nilai	Makna
REG_OPTION_CREATE_LINK 0x00000002L	Kuncinya adalah tautan simbolis. Jalur target ditetapkan ke nilai L"SymbolicLinkValue" kunci. Jalur target harus merupakan jalur registri absolut. Jika opsi ini diatur, REG_OPTION_NON_VOLATILE juga harus diatur. Jika parameter lpSubKey menentukan kunci yang ada, parameter tersebut harus dibuat dengan REG_OPTION_CREATE_LINK. Tautan simbolis registri harus digunakan hanya jika benar-benar diperlukan untuk kompatibilitas aplikasi.
REG_OPTION_NON_VOLATILE 0x00000000L	Kuncinya tidak volatil; ini adalah default. Informasi disimpan dalam file dan dipertahankan ketika sistem dimulai ulang. Fungsi ORSaveHive menyimpan kunci yang tidak volatil.

 

pSecurityDescriptor [dalam, opsional]

Penunjuk ke struktur SECURITY_DESCRIPTOR yang berisi pendeskripsi keamanan untuk kunci baru. Jika pSecurityDescriptor adalah NULL, kuncinya akan mendapatkan deskriptor keamanan default. ACL dalam deskriptor keamanan default untuk kunci diwarisi dari kunci induk langsungnya.

phkResult [out]

Penunjuk ke variabel yang menerima handel ke kunci yang dibuka atau dibuat. Gunakan fungsi ORCloseKey untuk menutup kunci setelah Anda selesai menggunakan handel.

pdwDisposition [out, opsional]

Penunjuk ke variabel yang menerima salah satu nilai disposisi berikut.

Nilai	Makna
REG_CREATED_NEW_KEY 0x00000001L	Kunci tidak ada dan dibuat.
REG_OPENED_EXISTING_KEY 0x00000002L	Kunci ada dan hanya dibuka tanpa diubah.

 

Jika pdwDispositionadalah NULL, tidak ada informasi disposisi yang dikembalikan.

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.

Jika parameter dwOptions diatur dengan REG_OPTION_CREATE_LINK tetapi REG_OPTION_NON_VOLATILE jelas, atau jika handel yang akan dikembalikan akan menjadi handel ke kunci akar sarang, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Keterangan

Kunci yang dibuat fungsi ORCreateKey tidak memiliki nilai. Aplikasi dapat menggunakan fungsi ORSetValue untuk mengatur nilai kunci.

Fungsi ORCreateKey tidak dapat digunakan untuk membuat kunci akar di sarang registri offline. Gunakan fungsi ORCreateHive untuk membuat kunci akar dan mendapatkan handel ke kunci.

Registri offline tidak mendukung penyimpanan kunci individual. Gunakan fungsi ORSaveHive untuk menyimpan kunci dan subkuncinya dalam sarang.

Persyaratan

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

Lihat juga

ORCloseKey

ORCreateHive

ORDeleteKey

ORSaveHive

SECURITY_DESCRIPTOR