Funzione RegLoadKeyA (winreg.h)

Articolo
11/20/2024

Crea una sottochiave in HKEY_USERS o HKEY_LOCAL_MACHINE e carica i dati dall'hive del Registro di sistema specificato in tale sottochiave.

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 RegLoadKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [in]           LPCSTR lpFile
);

Parametri

[in] hKey

Handle per la chiave in cui verrà creata la sottochiave. Può trattarsi di un handle restituito da una chiamata a RegConnectRegistryo uno degli handle predefiniti seguenti:

HKEY_LOCAL_MACHINEHKEY_USERS Questa funzione carica sempre le informazioni nella parte superiore della gerarchia del Registro di sistema. Impossibile specificare i valori di handle HKEY_CLASSES_ROOT e HKEY_CURRENT_USER per questo parametro, perché rappresentano rispettivamente i subset dei valori di handle HKEY_LOCAL_MACHINE e HKEY_USERS.

[in, optional] lpSubKey

Nome della chiave da creare in hKey. Questa sottochiave è la posizione in cui verranno caricate le informazioni di registrazione dal file.

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

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

[in] lpFile

Nome del file contenente i dati del Registro di sistema. Questo file deve essere un file locale creato con la funzione regSaveKey . Se il file non esiste, viene creato un file con il nome specificato.

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 con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore.

Osservazioni

Esistono due formati di file Hive del Registro di sistema. Gli hive del Registro di sistema creati nei sistemi operativi correnti in genere non possono essere caricati da quelli precedenti.

Se hKey è un handle restituito da RegConnectRegistry, il percorso specificato in lpFile è relativo al computer remoto.

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. Per caricare un hive senza richiedere questi privilegi speciali, usare la funzione RegLoadAppKey .

Nota

L'intestazione winreg.h definisce RegLoadKey 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