CAtlTransactionManager::RegCreateKeyEx

Erstellt den angegebenen Registrierungsschlüssel und ordnet ihn einer Transaktion zu.Wenn der Schlüssel bereits vorhanden ist, wird die Funktion diese.

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

Parameter

• hKey
  Ein Handle zu einem geöffneten Registrierungsschlüssel.

• lpSubKey
  Der Name eines Unterschlüssels, den diese Funktion wird oder erstellt.

• dwReserved
  Dieser Parameter ist reserviert und muss gleich sein.

• lpClass
  Die benutzerdefinierte Klasse dieser Schlüssel.Dieser Parameter wird ignoriert werden.Dieser Parameter kann NULL sein.

• dwOptions
  Dieser Parameter kann einen der folgenden Werte sein: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE oder REG_OPTION_VOLATILE.

• samDesired
  Eine Maske, die die Zugriffsrechte für den Schlüssel angibt.

• lpSecurityAttributes
  Zeiger auf eine SECURITY_ATTRIBUTES-Struktur, die bestimmt, ob das zurückgegebene Handle durch untergeordnete Prozesse geerbt werden kann.Wenn lpSecurityAttributesNULL ist, kann das Handle nicht geerbt werden.

• phkResult
  Ein Zeiger auf eine Variable, die ein Handle der geöffneten oder erstellten Schlüssel empfängt.Wenn der Schlüssel keiner der vordefinierten Registrierungsschlüssel ist, rufen Sie die RegCloseKey-Funktion auf, nachdem Sie mithilfe des Handles beendet haben.

• lpdwDisposition
  Ein Zeiger auf eine Variable, die einen der folgenden Einteilung empfängt, beschränkt: REG_CREATED_NEW_KEY oder REG_OPENED_EXISTING_KEY.

Rückgabewert

Wenn die Funktion folgt, ist der Rückgabewert ERROR_SUCCESS.Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich 0 (null), der in Winerror.h definiert ist.

Hinweise

Dieser Wrapper ruft die RegCreateKeyTransacted-Funktion auf.

Anforderungen

Header: atltransactionmanager.h

Siehe auch

Referenz

CAtlTransactionManager-Klasse