Funzione RegCopyTreeW (winreg.h)

Articolo
08/27/2023

Copia la chiave del Registro di sistema specificata, insieme ai relativi valori e sottochiavi, alla chiave di destinazione specificata.

Sintassi

LSTATUS RegCopyTreeW(
  [in]           HKEY    hKeySrc,
  [in, optional] LPCWSTR lpSubKey,
  [in]           HKEY    hKeyDest
);

Parametri

[in] hKeySrc

Handle per una chiave del Registro di sistema aperta. La chiave deve essere stata aperta con il diritto di accesso KEY_READ. Per altre informazioni, 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.

[in, optional] lpSubKey

Nome della chiave. Questa chiave deve essere una sottochiave della chiave identificata dal parametro hKeySrc . Questo parametro può anche essere NULL.

[in] hKeyDest

Handle alla chiave di destinazione. Il processo di chiamata deve avere KEY_CREATE_SUB_KEY accesso alla chiave.

Questo handle viene restituito dalla funzione RegCreateKeyEx o RegOpenKeyEx oppure può essere una delle chiavi predefinite.

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

Questa funzione copia anche il descrittore di sicurezza per la chiave.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Nota

L'intestazione winreg.h definisce RegCopyTree 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 Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winreg.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll

Vedi anche

Funzioni del Registro di sistema

Share via