Funzione SHCopyKeyA (shlwapi.h)

  • Articolo

Copia in modo ricorsivo le sottochiavi e i valori della sottochiave di origine nella chiave di destinazione. SHCopyKey non copia gli attributi di sicurezza delle chiavi.

Sintassi

LSTATUS SHCopyKeyA(
  [in]           HKEY   hkeySrc,
  [in, optional] LPCSTR pszSrcSubKey,
  [in]           HKEY   hkeyDest,
                 DWORD  fReserved
);

Parametri

[in] hkeySrc

Tipo: HKEY

Handle alla chiave di origine, ad esempio HKEY_CURRENT_USER.

[in, optional] pszSrcSubKey

Tipo: LPCTSTR

Sottochiave le cui sottochiavi e valori devono essere copiati.

[in] hkeyDest

Tipo: HKEY

Chiave di destinazione.

fReserved

Tipo: DWORD

Riservato. Deve essere 0.

Valore restituito

Tipo: LSTATUS

Restituisce ERROR_SUCCESS se ha esito positivo o uno dei codici di errore non zero definiti in Winerror.h in caso contrario. Usare FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per recuperare una descrizione generica dell'errore.

Commenti

Importante Questa funzione non duplica gli attributi di sicurezza delle chiavi e dei valori copiati. Invece, tutti gli attributi di sicurezza nella chiave di destinazione sono gli attributi predefiniti.
 

Nota

L'intestazione shlwapi.h definisce SHCopyKey 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, Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlwapi.h
Libreria Shlwapi.lib
DLL Shlwapi.dll (versione 5.0 o successiva)