S'identifier

API
Documentation
Ressources
Trucs & astuces
Libre
Gabarits
Services

Membres
Participer
Visiter

Contact

Meilleure résolution
mode 800 x 600

Optimisé pour
IE v.5
Netscape v.6
mais surtout pour
Mozilla v.1
minimum

 


Membre de Click-FR®, Réseau francophone Paie-Par-Click

SHCopyKey

Date de parution : 28/05/2003 - Cette fiche API a été lue 970 fois

Description

SHCopyKey copie récursivement les sous clés et valeurs d'un clé source dans une autre. La fonction retourne ERROR_SUCCESS (0) en cas de succès et un code erreur différent de zéro défini dans Winerror.h dans les autres cas. Vous pouvez utiliser FormatMessage avec le sémaphore FORMAT_MESSAGE_FROM_SYSTEM pour récupérer la description générique de l'erreur.

Syntaxe

AppelDLL32("shlwapi", "SHCopyKeyA", hKeySrc, &szSrcSubKey, hKeyDest, fReserved) 

hKeySrc
[e] Handle de la clé à copier défini par les valeurs suivantes :
HKEY_CLASSES_ROOT

2147483648

HKEY_CURRENT_CONFIG

2147483653

HKEY_CURRENT_USER

2147483649

HKEY_DYN_DATA
(Windows 95 seulement)

2147483654

HKEY_LOCAL_MACHINE

2147483650

HKEY_PERFORMANCE_DATA
(Windows NT seulement)

2147483652

HKEY_USERS

2147483651

 

szSrcSubKey
[e] Sous clé dont les sous clés et valeurs seront copiées.
hkeyDest
[e] Clé de destination.
fReserved
Réservé, doit être à Null.

Compatibilité

Supporté pour toutes les versions avec shlwapi.dll version 4.71 minimum

Remarque

La fonction ne duplique pas les attributs de sécurité des clés et valeurs copiées. Tout se retrouve avec les attributs de sécurité par défaut.

Exemple 1

// Copie d'une sous clé et de ses valeurs dans
// une autre sous clé
hKeySrc      est un entier long
szSrcSubKey  est une chaîne Asciiz sur 255
hKeyDest     est un entier long 

hKeySrc  = 2147483649 // HKCU
hKeyDest = 2147483650 // HKLM
szSrcSubKey = "Archive"
AppelDLL32("shlwapi", "SHCopyKeyA", ...
  hKeySrc, &szSrcSubKey, hKeyDest, Null)


Nombre de commentaire sur SHCopyKey : 0

Rappel : Le code fourni est compatible Windev v.4 et 5. Pour les versions supérieures, vous devez modifier le type des variables numériques. Par exemple : entier long devient entier.
Bien sûr, les marques citées sont déposées par leurs sociétés respectives. Ces pages sont à la disposition de tous, le code fourni est libre mais toute responsabilité est déclinée en cas de mauvais usage ou de dysfonctionnement.
© 2000-2005 Beaussier & Le Centre W..D..