Partager via


CAtlTransactionManager::RegCreateKeyEx

Crée la clé de Registre spécifiée et l'associe à une transaction. Si la clé existe déjà, la fonction l'ouvre.

inline LSTATUS CAtlTransactionManager::RegCreateKeyEx(
   HKEY hKey,
   LPCTSTR lpSubKey,
   DWORD dwReserved,
   LPTSTR lpClass,
   DWORD dwOptions,
   REGSAM samDesired,
   CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes,
   PHKEY phkResult,
   LPDWORD lpdwDisposition
);

Paramètres

  • hKey
    Un handle à une clé de Registre ouverte.

  • lpSubKey
    Le nom d'une sous-clé que cette fonction ouvre ou crée.

  • dwReserved
    Ce paramètre est réservé et doit être égal à zéro.

  • lpClass
    La classe définie par l'utilisateur de cette clé. Ce paramètre peut être ignoré. Ce paramètre peut être NULL.

  • dwOptions
    Ce paramètre peut avoir l'une des valeurs suivantes : REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE, ou REG_OPTION_VOLATILE.

  • samDesired
    Un masque qui spécifie les droits d'accès pour la clé.

  • lpSecurityAttributes
    Pointeur vers une structure de SECURITY_ATTRIBUTES qui détermine si le handle retourné peut être héritée par les processus enfant. Si lpSecurityAttributes est NULL, le handle ne peut pas être héritée.

  • phkResult
    Un pointeur vers une variable qui accepte un handle à la clé ouvert ou créé. Si la clé n'est pas l'une des clés de Registre prédéfinies, appelez la fonction d' RegCloseKey après avoir terminé d'utiliser le handle.

  • lpdwDisposition
    Un pointeur vers une variable qui accepte un de la disposition suivante donne : REG_CREATED_NEW_KEY ou REG_OPENED_EXISTING_KEY.

Valeur de retour

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.

Notes

Ce wrapper appelle la fonction d' RegCreateKeyTransacted .

Configuration requise

Header: atltransactionmanager.h

Voir aussi

Référence

CAtlTransactionManager, classe