Funzione RegRenameKey (winreg.h)

Articolo
03/13/2024

Modifica il nome della chiave del Registro di sistema specificata.

Sintassi

LSTATUS RegRenameKey(
  HKEY    hKey,
  LPCWSTR lpSubKeyName,
  LPCWSTR lpNewKeyName
);

Parametri

hKey

Handle per la chiave da rinominare. L'handle deve essere aperto con il diritto di accesso KEY_WRITE. Per altre informazioni, vedere Sicurezza e diritti di accesso delle chiavi del Registro di sistema.

Questo handle viene restituito dalla funzione RegCreateKeyEx o RegOpenKeyEx oppure può essere una delle chiavi predefinite seguenti:

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

lpSubKeyName

Nome della sottochiave da rinominare. Questa chiave deve essere una sottochiave della chiave identificata dal parametro hKey . Questo parametro può anche essere NULL, nel qual caso la chiave identificata dal parametro hKey verrà rinominata.

lpNewKeyName

Nuovo nome della chiave. Il nuovo nome non deve esistere già.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'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.

Commenti

Questa funzione può essere usata 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

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	winreg.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll

Vedi anche

RegCopyTree

Funzioni del Registro di sistema

Panoramica del Registro di sistema

SECURITY_ATTRIBUTES

Condividi tramite