次の方法で共有


CAtlTransactionManager::RegCreateKeyEx

指定したレジストリ キーを作成してトランザクションに関連付けます。キーが既に存在する場合は、そのキーが開かれます。

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

パラメーター

  • hKey
    開いているレジストリ キーへのハンドル。

  • lpSubKey
    この関数によって開かれるサブキーまたは作成されるサブキーの名前。

  • dwReserved
    このパラメーターは予約されており、0 にする必要があります。

  • lpClass
    このキーのユーザー定義クラス。このパラメーターは無視される場合があります。このパラメーターには、NULL を指定できます。

  • dwOptions
    このパラメーターには、REG_OPTION_BACKUP_RESTORE、REG_OPTION_NON_VOLATILE、REG_OPTION_VOLATILE のいずれかの値を指定できます。

  • samDesired
    キーのアクセス権を指定するマスク。

  • lpSecurityAttributes
    SECURITY_ATTRIBUTES 構造体へのポインター。この構造体は、返されたハンドルを子プロセスが継承できるかどうかを決定します。lpSecurityAttributes が NULL の場合、ハンドルは継承できなくなります。

  • phkResult
    開かれたキーまたは作成されたキーへのハンドルを受け取る変数へのポインター。キーが定義済みのレジストリ キーでない場合は、ハンドルを使い終えた後に RegCloseKey 関数を呼び出す必要があります。

  • lpdwDisposition
    配置値の 1 つを受け取る変数へのポインター。REG_CREATED_NEW_KEY または REG_OPENED_EXISTING_KEY が格納されます。

戻り値

成功した場合は、ERROR_SUCCESS を返します。関数が失敗した場合は、Winerror.h で定義されている 0 以外のエラー コードが返されます。

解説

このラッパーは、RegCreateKeyTransacted 関数を呼び出します。

必要条件

ヘッダー: atltransactionmanager.h

参照

関連項目

CAtlTransactionManager クラス