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.