RegCreateKeyTransactedW

指定したレジストリキーを作成し、トランザクションに関連付ける。(Unicode)

RegCreateKeyTransactedW hKey, lpSubKey, Reserved, lpClass, dwOptions, samDesired, lpSecurityAttributes, phkResult, lpdwDisposition, hTransaction, pExtendedParemeter

hKey : [intptr] 開かれているレジストリキーへのハンドル。呼び出し側プロセスはそのキーに対する KEY_CREATE_SUB_KEY アクセス権を持っている必要がある。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。キー作成のアクセス権は、ハンドル取得時に指定したアクセスマスクではなく、レジストリキーのセキュリティ記述子に対して検査される。したがって、hKey が KEY_READ の samDesired で開かれていても、セキュリティ記述子が許可していればキー作成操作に使用できる。このハンドルは RegCreateKeyTransacted または RegOpenKeyTransacted 関数が返すか、以下の定義済みキーのいずれかを指定できる:
lpSubKey : [wstr] この関数が開くか作成するサブキーの名前。指定するサブキーは hKey パラメータで識別されるキーのサブキーでなければならず、レジストリツリー内で最大 32 レベルの深さまで指定できる。キー名に関する詳細はレジストリの構造を参照のこと。lpSubKey が空文字列へのポインタである場合、phkResult は hKey で指定したキーへの新しいハンドルを受け取る。このパラメータは NULL にできない。
Reserved : [int] このパラメータは予約されており、0 でなければならない。
lpClass : [wstr] このキーのユーザ定義クラス。このパラメータは無視される場合がある。NULL を指定できる。
dwOptions : [int] 
samDesired : [int] 作成するキーに対するアクセス権を指定するマスク。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
lpSecurityAttributes : [var] 子プロセスが返されたハンドルを継承できるかどうかを決定する SECURITY_ATTRIBUTES 構造体へのポインタ。lpSecurityAttributes が NULL の場合、ハンドルは継承できない。
phkResult : [intptr] 開いたまたは作成したキーへのハンドルを受け取る変数へのポインタ。キーが定義済みレジストリキーでない場合、ハンドルの使用が終わったら RegCloseKey 関数を呼び出す。
lpdwDisposition : [var] 次の処理結果値のいずれかを受け取る変数へのポインタ。
hTransaction : [intptr] アクティブなトランザクションへのハンドル。このハンドルは CreateTransaction 関数が返す。
pExtendedParemeter : [intptr] このパラメータは予約されており、NULL でなければならない。

(プラグイン / モジュール : advapi32.dll)

解説

指定したレジストリキーを作成し、トランザクションに関連付ける。(Unicode)

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は Winerror.h で定義された 0
以外のエラーコードとなる。FormatMessage 関数に FORMAT_MESSAGE_FROM_SYSTEM
フラグを指定して呼び出すと、エラーの一般的な説明を取得できる。

[備考]

この関数を使用してキーを作成すると、そのキーに対する後続の操作はトランザクション化される。トランザクションがコミットされる前に非トランザクション操作がキーに対して実行されると、トランザクションはロールバックされる。トランザクションがコミットまたはロールバックされた後、追加の操作をトランザクション化するには、アクティブなトランザクションハンドルを指定して
RegCreateKeyTransacted または RegOpenKeyTransacted
でキーを開き直す必要がある。トランザクションの詳細についてはカーネルトランザクションマネージャを参照のこと。このキーのサブキーに対する後続の操作は自動的にはトランザクション化されない点に注意のこと。したがって、RegDeleteKeyEx
はトランザクション化された削除操作を行わない。代わりに RegDeleteKeyTransacted
関数を使用すること。RegCreateKeyTransacted 関数が作成するキーには値はない。アプリケーションは
RegSetValueEx 関数を使用してキー値を設定できる。RegCreateKeyTransacted
関数は指定したパス内の不足するすべてのキーを作成する。この動作を利用して、複数のキーを一度に作成できる。たとえば、lpSubKey
パラメータに subkey1\subkey2\subkey3\subkey4 のような文字列を指定することで、4
レベル下のサブキーと同時に先行する 3
つのサブキーを作成できる。なお、パス内の既存キーのつづりが誤っている場合、この動作によって意図しないキーが作成される。アプリケーションは
HKEY_USERS や HKEY_LOCAL_MACHINE の直下のキーを作成できない。HKEY_USERS や
HKEY_LOCAL_MACHINE ツリーのより下位のレベルではサブキーを作成できる。
> [!NOTE] > winreg.h ヘッダは RegCreateKeyTransacted
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報