CAtlTransactionManager::RegCreateKeyEx

Creare la chiave del Registro di sistema specificato e lo associa a una transazione.Se la chiave già esiste, la funzione viene aperta.

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

Parametri

• hKey
  Handle a una chiave del Registro di sistema aperta.

• lpSubKey
  Il nome di una sottochiave che questa funzione consente di aprire o creare.

• dwReserved
  Questo parametro è riservato e deve essere zero.

• lpClass
  La classe definita dall'utente di questa chiave.Questo parametro può essere ignorato.Questo parametro può essere NULL.

• dwOptions
  Questo parametro può essere uno dei seguenti valori: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE, o REG_OPTION_VOLATILE.

• samDesired
  Una maschera che specifica i diritti di accesso per la chiave.

• lpSecurityAttributes
  Puntatore a una struttura di SECURITY_ATTRIBUTES che determina se gli handle restituiti possono essere ereditate dai processi figlio.Se lpSecurityAttributes è NULL, handle non possono essere ereditate.

• phkResult
  Un puntatore a una variabile che riceve un handle di chiave aperta o creata.Se la chiave non è una delle chiavi del Registro di sistema predefinite, chiamare la funzione RegCloseKey dopo avere terminato l'utilizzo di handle.

• lpdwDisposition
  Un puntatore a una variabile che riceve uno dei valori disponibili: REG_CREATED_NEW_KEY o REG_OPENED_EXISTING_KEY.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h.

Note

Questo wrapper chiama la funzione RegCreateKeyTransacted.

Requisiti

Header: atltransactionmanager.h

Vedere anche

Riferimenti

Classe di CAtlTransactionManager