Funzione NtRenameKey (winternl.h)

[Questa funzione può essere modificata o rimossa da Windows senza ulteriori preavviso. ]

Modifica il nome della chiave del Registro di sistema specificata.

Sintassi

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

Parametri

[in] KeyHandle

Handle per la chiave da rinominare. L'handle deve essere aperto con il diritto di accesso KEY_WRITE.

[in] NewName

Puntatore a una stringa UNICODE che rappresenta il nuovo nome della chiave.

Valore restituito

Restituisce un codice NTSTATUS o di errore. Un codice di errore di STATUS_ACCESS_DENIED indica che il chiamante non dispone dei diritti di accesso necessari per la chiave o le sottochiavi del Registro di sistema specificate.

Le forme e il significato dei codici di errore NTSTATUS sono elencati nel file di intestazione Ntstatus.h disponibile in WDK e sono descritti nella documentazione di WDK.

Commenti

Questa funzione non ha alcun file di intestazione associato. È anche possibile usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Ntdll.dll.

La funzione NtRenameKey può essere utilizzata per rinominare un intero sottoalbero del Registro di sistema. Il chiamante deve avere KEY_CREATE_SUB_KEY accesso all'elemento padre della chiave specificata e all'accesso DELETE all'intero sottoalbero da rinominare.

Requisiti

Vedi anche

Diritti di accesso e sicurezza delle chiavi del Registro di sistema