Funzione RegDeleteKeyW (winreg.h)

Articolo
03/04/2024

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 RegDeleteKeyW(
  [in] HKEY    hKey,
  [in] LPCWSTR 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

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

Requisito	Valore
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