Funzione RegCopyTreeA (winreg.h)

Articolo
11/20/2024

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

Sintassi

LSTATUS RegCopyTreeA(
  [in]           HKEY   hKeySrc,
  [in, optional] LPCSTR 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 per la chiave di destinazione. Il processo chiamante 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.

Osservazioni

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 versione successiva. 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 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winreg.h (include Windows.h)
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

funzioni del Registro di sistema

Condividi tramite