RegOpenKeyTransactedW

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

RegOpenKeyTransactedW hKey, lpSubKey, ulOptions, samDesired, phkResult, hTransaction, pExtendedParemeter

hKey : [intptr] 開かれているレジストリキーへのハンドル。このハンドルは RegCreateKeyEx、RegCreateKeyTransacted、RegOpenKeyEx、または RegOpenKeyTransacted 関数が返す。以下の定義済みキーのいずれかを指定することもできる: HKEY_CLASSES_ROOT HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS
lpSubKey : [wstr] 開くレジストリサブキーの名前。キー名は大文字小文字を区別しない。lpSubKey パラメータが NULL または空文字列へのポインタで、hKey が定義済みキーである場合、システムは定義済みキーをリフレッシュし、phkResult は関数に渡されたものと同じ hKey ハンドルを受け取る。そうでない場合、phkResult は開かれたキーへの新しいハンドルを受け取る。詳細はレジストリ要素サイズ制限を参照のこと。
ulOptions : [int] このパラメータは予約されており、0 でなければならない。
samDesired : [int] キーに対して要求するアクセス権を指定するマスク。キーのセキュリティ記述子が呼び出し側プロセスに対して要求されたアクセスを許可しない場合、関数は失敗する。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
phkResult : [intptr] 開かれたキーへのハンドルを受け取る変数へのポインタ。キーが定義済みレジストリキーでない場合、ハンドルの使用が終わったら RegCloseKey 関数を呼び出す。
hTransaction : [intptr] アクティブなトランザクションへのハンドル。このハンドルは CreateTransaction 関数が返す。
pExtendedParemeter : [intptr] このパラメータは予約されており、NULL でなければならない。

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

解説

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

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

[備考]

この関数を使用してキーを開くと、そのキーに対する後続の操作はトランザクション化される。トランザクションがコミットされる前に非トランザクション操作がキーに対して実行されると、トランザクションはロールバックされる。トランザクションがコミットまたはロールバックされた後、追加の操作をトランザクション化するには、アクティブなトランザクションハンドルを指定して
RegCreateKeyTransacted または RegOpenKeyTransacted
関数でキーを開き直す必要がある。トランザクションの詳細についてはカーネルトランザクションマネージャを参照のこと。このキーのサブキーに対する後続の操作は自動的にはトランザクション化されない点に注意のこと。したがって、RegDeleteKeyEx
関数はトランザクション化された削除操作を行わない。代わりに RegDeleteKeyTransacted
関数を使用すること。RegCreateKeyTransacted 関数とは異なり、RegOpenKeyTransacted
関数は指定したキーがレジストリに存在しない場合にキーを作成しない。サービスやアプリケーションが複数のユーザをインパーソネートする場合、この関数を
HKEY_CURRENT_USER に対して使用してはならない。代わりに RegOpenCurrentUser
関数を呼び出す。phkResult
で返されるキーが定義済みレジストリキーである場合、そのキーは提供されたトランザクションには含まれない。単一のレジストリキーは 65,534
回しか開くことができない。65,535 回目のオープン操作を試行すると、この関数は ERROR_NO_SYSTEM_RESOURCES
で失敗する。
> [!NOTE] > winreg.h ヘッダは RegOpenKeyTransacted
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報