NtRenameKey 関数 (winternl.h)
[この機能は、予告なしに Windows から変更または削除される場合があります。 ]
指定したレジストリ キーの名前を変更します。
構文
__kernel_entry NTSTATUS NtRenameKey(
[in] HANDLE KeyHandle,
[in] PUNICODE_STRING NewName
);
パラメーター
[in] KeyHandle
名前を変更するキーのハンドル。 ハンドルは、KEY_WRITEアクセス権を使用して開く必要があります。
[in] NewName
キーの新しい名前である UNICODE 文字列へのポインター。
戻り値
NTSTATUS またはエラー コードを返します。 STATUS_ACCESS_DENIEDのエラー コードは、呼び出し元に、指定されたレジストリ キーまたはサブキーに対する必要なアクセス権がないことを示します。
NTSTATUS エラー コードの形式と重要性は、WDK で使用できる Ntstatus.h ヘッダー ファイルに記載されており、WDK ドキュメントで説明されています。
注釈
この関数には、関連付けられたヘッダー ファイルがありません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Ntdll.dll に動的にリンクすることもできます。
NtRenameKey 関数を使用して、レジストリ サブツリー全体の名前を変更できます。 呼び出し元には、指定したキーの親への KEY_CREATE_SUB_KEY アクセス権と、名前を変更するサブツリー全体への DELETE アクセス権が必要です。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | winternl.h |
| Library | ntdll.lib |
| [DLL] | ntdll.dll |