Fungsi ORQueryInfoKey

Artikel
06/12/2023

Mengambil informasi tentang kunci registri yang ditentukan dalam sarang registri offline.

Sintaks

DWORD ORQueryInfoKey(
  _In_        ORHKEY    Handle,
  _Out_opt_   PWSTR     lpClass,
  _Inout_opt_ PDWORD    lpcClass,
  _Out_opt_   PDWORD    lpcSubKeys,
  _Out_opt_   PDWORD    lpcMaxSubKeyLen,
  _Out_opt_   PDWORD    lpcMaxClassLen,
  _Out_opt_   PDWORD    lpcValues,
  _Out_opt_   PDWORD    lpcMaxValueNameLen,
  _Out_opt_   PDWORD    lpcMaxValueLen,
  _Out_opt_   PDWORD    lpcbSecurityDescriptor,
  _Out_opt_   PFILETIME lpftLastWriteTime
);

Parameter

Handel [in]

Handel ke kunci registri terbuka di sarang registri offline.

lpClass [keluar, opsional]

Penunjuk ke buffer yang menerima kelas kunci. Parameter ini bisa NULL.

lpcClass [masuk, keluar, opsional]

Penunjuk ke variabel yang menentukan ukuran buffer yang diacu oleh parameter lpClass , dalam karakter.

Ukuran harus mencakup karakter null yang mengakhiri. Saat fungsi kembali, variabel ini berisi ukuran string kelas yang disimpan dalam buffer. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri. Jika buffer tidak cukup besar, fungsi mengembalikan ERROR_MORE_DATA, dan variabel berisi ukuran string, dalam karakter, tanpa menghitung karakter null yang mengakhiri.

Jika lpClassADALAH NULL, lpcClass bisa NULL.

Jika parameter lpClass adalah alamat yang valid, tetapi parameter lpcClass tidak (misalnya, jika parameter lpcClassadalah NULL) maka fungsi mengembalikan ERROR_INVALID_PARAMETER.

lpcSubKeys [keluar, opsional]

Penunjuk ke variabel yang menerima jumlah subkunci yang dimuat oleh kunci yang ditentukan. Parameter ini bisa NULL.

lpcMaxSubKeyLen [out, opsional]

Penunjuk ke variabel yang menerima ukuran subkunci kunci dengan nama terpanjang, dalam karakter Unicode, tidak termasuk karakter null yang mengakhiri. Parameter ini bisa NULL.

lpcMaxClassLen [out, opsional]

Penunjuk ke variabel yang menerima ukuran string terpanjang yang menentukan kelas subkunci, dalam karakter Unicode. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri. Parameter ini bisa NULL.

lpcValues [out, opsional]

Penunjuk ke variabel yang menerima jumlah nilai yang terkait dengan kunci. Parameter ini bisa NULL.

lpcMaxValueNameLen [out, opsional]

Penunjuk ke variabel yang menerima ukuran nama nilai terpanjang kunci, dalam karakter Unicode. Ukuran tidak termasuk karakter null yang mengakhiri. Parameter ini bisa NULL.

lpcMaxValueLen [out, opsional]

Penunjuk ke variabel yang menerima ukuran komponen data terpanjang di antara nilai kunci, dalam byte. Parameter ini bisa NULL.

lpcbSecurityDescriptor [out, opsional]

Penunjuk ke variabel yang menerima ukuran deskriptor keamanan kunci, dalam byte. Parameter ini bisa NULL.

lpftLastWriteTime [out, opsional]

Penunjuk ke struktur FILETIME yang menerima waktu tulis terakhir. Parameter ini bisa NULL.

Fungsi ini mengatur anggota struktur FILETIME untuk menunjukkan kapan terakhir kali kunci atau entri nilainya dimodifikasi.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan 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 buffer lpClass terlalu kecil untuk menerima nama kelas, fungsi akan mengembalikan ERROR_MORE_DATA.

Persyaratan

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

Lihat juga

FILETIME
ORCreateKey
OROpenKey
ORDeleteKey

Bagikan melalui