Fonction RegRenameKey (winreg.h)
Modifie le nom de la clé de Registre spécifiée.
Syntaxe
LSTATUS RegRenameKey(
HKEY hKey,
LPCWSTR lpSubKeyName,
LPCWSTR lpNewKeyName
);
Paramètres
hKey
Handle de la clé à renommer. Le handle doit être ouvert avec le droit d’accès KEY_WRITE. Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.
Ce handle est retourné par la fonction RegCreateKeyEx ou RegOpenKeyEx , ou il peut s’agir de l’une des clés prédéfinies suivantes :
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
lpSubKeyName
Nom de la sous-clé à renommer. Cette clé doit être une sous-clé de la clé identifiée par le paramètre hKey . Ce paramètre peut également avoir la valeur NULL, auquel cas la clé identifiée par le paramètre hKey sera renommée.
lpNewKeyName
Nouveau nom de la clé. Le nouveau nom ne doit pas déjà exister.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur. Un code d’erreur de STATUS_ACCESS_DENIED indique que l’appelant ne dispose pas des droits d’accès nécessaires à la ou aux sous-clés de Registre spécifiées.
Remarques
Cette fonction peut être utilisée pour renommer une sous-arborescence de Registre entière. L’appelant doit avoir KEY_CREATE_SUB_KEY accès au parent de la clé spécifiée et l’accès DELETE à l’ensemble de la sous-arborescence en cours de renommage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | winreg.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |