Funzione RegUnLoadKeyA (winreg.h)

Articolo
03/04/2024

Scarica la chiave del Registro di sistema specificata e le relative sottochiavi dal Registro di sistema.

Le applicazioni che esegue il backup o il ripristino dello stato del sistema, inclusi i file di sistema e gli hive del Registro di sistema, devono usare il servizio Copia Shadow del volume anziché le funzioni del Registro di sistema.

Sintassi

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

Parametri

[in] hKey

Handle per la chiave del Registro di sistema da scaricare. Questo parametro può essere un handle restituito da una chiamata alla funzione RegConnectRegistry o da uno degli handle predefiniti seguenti:

HKEY_LOCAL_MACHINE HKEY_USERS

[in, optional] lpSubKey

Nome della sottochiave da scaricare. La chiave a cui fa riferimento il parametro lpSubKey deve essere stata creata usando la funzione RegLoadKey .

I nomi delle chiavi non fanno 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 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.

Commenti

Questa funzione rimuove un hive dal Registro di sistema, ma non modifica il file contenente le informazioni del Registro di sistema. Un hive è un corpo discreto di chiavi, sottochiavi e valori radicati nella parte superiore della gerarchia del Registro di sistema.

Il processo chiamante deve avere i privilegi SE_RESTORE_NAME e SE_BACKUP_NAME nel computer in cui risiede il Registro di sistema. Per altre informazioni, vedere Esecuzione con privilegi speciali.

Nota

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

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