Crée la clé de registre spécifiée
#include <WinAPIReg.au3>
_WinAPI_RegCreateKey ( $hKey [, $sSubKey = '' [, $iAccess = $KEY_ALL_ACCESS [, $iOptions = 0 [, $tSecurity = 0]]]] )
| $hKey |
Handle de la clé de registre ouvert. Si la clé existe déjà, la fonction l'ouvre. Le processus appelant doit avoir l'accès $KEY_CREATE_SUB_KEY à la clé. Ce handle est retourné par la fonction _WinAPI_RegCreateKey() ou _WinAPI_RegOpenKey(), ou bien il peut être l'une des clés prédéfinis suivantes: $HKEY_CLASSES_ROOT $HKEY_CURRENT_CONFIG $HKEY_CURRENT_USER $HKEY_LOCAL_MACHINE $HKEY_USERS |
| $sSubKey | [optionnel] Le nom de la sous-clé que cette fonction doit ouvrir ou créer. La sous-clé spécifiée doit être une sous-clé de la clé identifiée par le paramètre $hKey; elle peut être jusqu'à 32 niveaux de profondeur dans l'arborescence du registre. Si ce paramètre est la chaîne vide (par défaut), la valeur de retour est un nouveau handle de la clé spécifiée par $hKey. |
| $iAccess | [optionnel] Le masque qui spécifie les droits d'accès pour la clé. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes: $KEY_ALL_ACCESS $KEY_CREATE_LINK $KEY_CREATE_SUB_KEY $KEY_ENUMERATE_SUB_KEYS $KEY_EXECUTE $KEY_NOTIFY $KEY_QUERY_VALUE $KEY_READ $KEY_SET_VALUE $KEY_WOW64_32KEY $KEY_WOW64_64KEY $KEY_WRITE |
| $iOptions | [optionnel] Ce paramètre peut prendre l'une des valeurs suivantes: $REG_OPTION_BACKUP_RESTORE $REG_OPTION_CREATE_LINK $REG_OPTION_NON_VOLATILE (par défaut) $REG_OPTION_VOLATILE |
| $tSecurity | [optionnel] Structure $tagSECURITY_ATTRIBUTES qui détermine si le handle retourné peut être hérité par les processus enfants. Si ce paramètre est 0 (par défaut), le handle ne peut pas être hérité. |
| Succès: | Retourne le handle de la clé ouverte ou créée, @extended contiendra une des valeurs suivantes: 0 (False) - La clé existait et a été simplement ouverte sans être changé. 1 (True) - La clé n'existait pas et a été créée. |
| Échec: | Définit @error <> 0, @extended peut contenir le code d'erreur du système. |
Une application ne peut pas créer une clé qui est un enfant direct de HKEY_USERS ou HKEY_LOCAL_MACHINE. Une application peut créer des sous-clés de niveaux inférieurs des arbres HKEY_USERS ou HKEY_LOCAL_MACHINE.
Si la clé n'est pas l'une des clés de registre prédéfinis ($HKEY_*), vous devez appeler la fonction _WinAPI_RegCloseKey() après avoir terminé d'utiliser le handle.
Consultez RegCreateKeyEx dans la librairie MSDN.