Funzione RegDeleteKeyA (winreg.h)

Articolo
08/27/2023

Elimina una sottochiave e i relativi valori. Si noti che i nomi delle chiavi non sono distinzione tra maiuscole e minuscole.

Windows a 64 bit: In WOW64, le applicazioni a 32 bit visualizzano un albero del Registro di sistema separato dall'albero del Registro di sistema visualizzato dalle applicazioni a 64 bit. Per abilitare un'applicazione per eliminare una voce nella visualizzazione del Registro di sistema alternativo, usare la funzione RegDeleteKeyEx .

Sintassi

LSTATUS RegDeleteKeyA(
  [in] HKEY   hKey,
  [in] LPCSTR lpSubKey
);

Parametri

[in] hKey

Handle per una chiave del Registro di sistema aperta. I diritti di accesso di questa chiave non influiscono sull'operazione di eliminazione. Per altre informazioni sui diritti di accesso, vedere Sicurezza delle chiavi del Registro di sistema e diritti di accesso.

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

[in] lpSubKey

Nome della chiave da eliminare. Deve essere una sottochiave della chiave identificata da hKey , ma non può avere sottochiave. Questo parametro non può essere NULL.

La funzione apre la sottochiave con il diritto di accesso DELETE.

I nomi delle chiavi non sono distinzione tra maiuscole e minuscole.

Per altre informazioni, vedere Limiti delle dimensioni degli elementi del Registro di sistema.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. Per ottenere una descrizione generica dell'errore, è possibile usare la funzione FormatMessage con il flag di FORMAT_MESSAGE_FROM_SYSTEM.

Commenti

Una chiave eliminata non viene rimossa fino all'ultima chiusura dell'handle.

La sottochiave da eliminare non deve avere sottochiave. Per eliminare una chiave e tutte le relative sottochiavi, è necessario enumerare le sottochiave ed eliminarle singolarmente. Per eliminare le chiavi in modo ricorsivo, usare la funzione RegDeleteTree o SHDeleteKey.

Esempio

Per un esempio che usa questa funzione, vedere Eliminazione di una chiave con sottochiave.

Nota

Nelle versioni legacy di Windows, questa API viene esposta anche da kernel32.dll.

Nota

L'intestazione winreg.h definisce RegDeleteKey come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winreg.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll