UDF > WinAPIEx > Registry >


_WinAPI_RegCreateKey

Cr�e la cl� de registre sp�cifi�e

#include <WinAPIReg.au3>
_WinAPI_RegCreateKey ( $hKey [, $sSubKey = '' [, $iAccess = $KEY_ALL_ACCESS [, $iOptions = 0 [, $tSecurity = 0]]]] )

Param�tres

$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�.

Valeur de retour

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.

Remarques

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.

En relation

_WinAPI_RegOpenKey

Voir aussi

Consultez RegCreateKeyEx dans la librairie MSDN.