RegSaveKeyExW

指定したキーとそのすべてのサブキーおよび値を、指定した形式でレジストリファイルに保存する。(Unicode)

RegSaveKeyExW hKey, lpFile, lpSecurityAttributes, Flags

hKey : [intptr] 開かれているレジストリキーへのハンドル。この関数は HKEY_CLASSES_ROOT 定義済みキーをサポートしない。
lpFile : [wstr] 指定したキーとサブキーを保存するファイルの名前。ファイルがすでに存在する場合、関数は失敗する。
lpSecurityAttributes : [var] 新しいファイルのセキュリティ記述子を指定する SECURITY_ATTRIBUTES 構造体へのポインタ。lpSecurityAttributes が NULL の場合、ファイルには既定のセキュリティ記述子が割り当てられる。ファイルの既定のセキュリティ記述子の ACL は、親ディレクトリから継承される。
Flags : [int] 

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

解説

指定したキーとそのすべてのサブキーおよび値を、指定した形式でレジストリファイルに保存する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は Winerror.h で定義された 0
以外のエラーコードとなる。FormatMessage 関数に FORMAT_MESSAGE_FROM_SYSTEM
フラグを指定して呼び出すと、エラーの一般的な説明を取得できる。この関数への 1 回の呼び出しで Flags
パラメータに上記の複数の値が指定された場合（たとえば 2 つ以上の値が OR されている場合）、または
REG_NO_COMPRESSION が指定されているが hKey がハイブのルートでないキーを指定している場合、この関数は
ERROR_INVALID_PARAMETER を返す。

[備考]
RegSaveKey とは異なり、この関数は HKEY_CLASSES_ROOT 定義済みキーをサポートしない。hKey
がリモートコンピュータ上のキーを表す場合、lpFile で指定されたパスはリモートコンピュータに対する相対となる。RegSaveKeyEx
関数は不揮発性キーのみを保存し、揮発性キーは保存しない。キーは作成時に揮発性または不揮発性となる。RegCreateKeyEx
を参照のこと。RegSaveKeyEx で作成したファイルは、RegLoadKey、RegReplaceKey、または
RegRestoreKey 関数の後続の呼び出しで使用できる。RegSaveKeyEx
が操作の途中で失敗した場合、ファイルは破損し、そのファイルに対する
RegLoadKey、RegReplaceKey、RegRestoreKey の後続の呼び出しは失敗する。RegSaveKeyEx と
RegRestoreKey
を併用してレジストリ内のサブツリーをコピーすることは推奨されない。この方法は通知をトリガーせず、他のアプリケーションが使用しているハンドルを無効にする可能性がある。代わりに
SHCopyKey 関数または RegCopyTree 関数を使用すること。呼び出し側プロセスは SE_BACKUP_NAME
特権を有効にしておく必要がある。詳細は特殊な特権での実行を参照のこと。
> [!NOTE] > winreg.h ヘッダは RegSaveKeyEx をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報