Funzione RegRenameKey (winreg.h)

  • Articolo

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