Fungsi NtQueryMultipleValueKey (winternl.h)

[Fungsi ini dapat diubah atau dihapus dari Windows tanpa pemberitahuan lebih lanjut.]

Mengambil nilai untuk kunci multinilai yang ditentukan.

Sintaks

__kernel_entry NTSTATUS NtQueryMultipleValueKey(
  [in]            HANDLE           KeyHandle,
  [in, out]       PKEY_VALUE_ENTRY ValueEntries,
  [in]            ULONG            EntryCount,
  [out]           PVOID            ValueBuffer,
  [in, out]       PULONG           BufferLength,
  [out, optional] PULONG           RequiredBufferLength
);

Parameter

[in] KeyHandle

Handel ke kunci untuk mengambil nilai. Handel harus dibuka dengan hak akses KEY_QUERY_VALUE .

[in, out] ValueEntries

Penunjuk ke array struktur [KEY_VALUE_ENTRY] yang berisi nama nilai yang akan diambil.

[in] EntryCount

Jumlah elemen dalam array ValueEntries .

[out] ValueBuffer

Penunjuk ke buffer untuk menerima nilai.

[in, out] BufferLength

Penunjuk ke variabel yang berisi ukuran buffer di ValueBuffer, dalam byte. Saat fungsi kembali, parameter BufferLength berisi jumlah byte yang ditulis ke buffer di ValueBuffer.

[out, optional] RequiredBufferLength

Penunjuk ke variabel untuk menerima jumlah byte yang diperlukan agar semua nilai dikembalikan oleh fungsi. Parameter ini bisa NULL.

Mengembalikan nilai

Mengembalikan NTSTATUS atau kode kesalahan.

Jika buffer terlalu kecil untuk menyimpan informasi yang akan diambil, fungsi mengembalikan STATUS_BUFFER_OVERFLOW dan, jika parameter RequiredBufferLength ditentukan, atur ke ukuran buffer yang diperlukan.

Formulir dan signifikansi kode kesalahan NTSTATUS tercantum dalam file header Ntstatus.h yang tersedia di WDK, dan dijelaskan dalam dokumentasi WDK.

Keterangan

Fungsi ini tidak memiliki file header terkait. Anda juga dapat menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Ntdll.dll.

Persyaratan

Target Platform	Windows
Header	winternl.h
Pustaka	ntdll.lib
DLL	ntdll.dll

Lihat juga

Keamanan Kunci Registri dan Hak Akses