Fungsi NtRenameKey (winternl.h)

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

Mengubah nama kunci registri yang ditentukan.

Sintaks

__kernel_entry NTSTATUS NtRenameKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING NewName
);

Parameter

[in] KeyHandle

Handel ke kunci yang akan diganti namanya. Handel harus dibuka dengan hak akses KEY_WRITE.

[in] NewName

Penunjuk ke string UNICODE yang merupakan nama baru untuk kunci.

Mengembalikan nilai

Mengembalikan NTSTATUS atau kode kesalahan. Kode kesalahan STATUS_ACCESS_DENIED menunjukkan bahwa pemanggil tidak memiliki hak akses yang diperlukan ke kunci registri atau subkunci yang ditentukan.

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.

Fungsi NtRenameKey dapat digunakan untuk mengganti nama seluruh subtree registri. Pemanggil harus memiliki akses KEY_CREATE_SUB_KEY ke induk kunci yang ditentukan dan akses DELETE ke seluruh subtree yang diganti namanya.

Persyaratan

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

Lihat juga

Keamanan Kunci Registri dan Hak Akses