Funzione RegUnLoadKeyA (winreg.h)
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 a funzione RegConnectRegistry o da uno degli handle predefiniti seguenti:
HKEY_LOCAL_MACHINEHKEY_USERS
[in, optional] lpSubKey
Nome della sottochiave da scaricare. La chiave a cui fa riferimento il parametro lpSubKey
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 è 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
Osservazioni
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 disporre dei 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows 2000 Professional [solo app desktop] |
server minimo supportato | Windows 2000 Server [solo app desktop] |
piattaforma di destinazione | Finestre |
intestazione |
winreg.h (include Windows.h) |
libreria |
Advapi32.lib |
dll | Advapi32.dll |