Funzione RegReplaceKeyA (winreg.h)

Articolo
03/13/2024

Sostituisce il backup di una chiave del Registro di sistema e tutte le relative sottochiavi con un altro file, in modo che al successivo avvio del sistema, le chiavi e le sottochiavi avranno i valori archiviati nel nuovo file.

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

Sintassi

LSTATUS RegReplaceKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [in]           LPCSTR lpNewFile,
  [in]           LPCSTR lpOldFile
);

Parametri

[in] hKey

Handle per una chiave del Registro di sistema aperta. 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, optional] lpSubKey

Nome della chiave del Registro di sistema i cui sottochiavi e valori devono essere sostituiti. Se esiste la chiave, deve essere una sottochiave della chiave identificata dal parametro hKey . Se la sottochiave non esiste, viene creata. Questo parametro può essere NULL.

Se la sottochiave specificata non è la radice di un hive, RegReplaceKey attraversa la struttura dell'albero hive finché non rileva una radice hive, sostituisce il contenuto di tale hive con il contenuto del file di dati specificato da lpNewFile.

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

[in] lpNewFile

Nome del file con le informazioni del Registro di sistema. Questo file viene in genere creato usando la funzione RegSaveKey .

[in] lpOldFile

Nome del file che riceve una copia di backup delle informazioni del Registro di sistema sostituite.

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.

Commenti

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

Il file specificato dal parametro lpNewFile rimane aperto fino al riavvio del sistema.

Se hKey è un handle restituito da RegConnectRegistry, i percorsi specificati in lpNewFile e lpOldFile sono relativi al computer remoto.

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 RegReplaceKey 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