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 アクセス権が必要です。