NtRenameKey-Funktion (winternl.h)

[Diese Funktion kann ohne weitere Ankündigung geändert oder aus Windows entfernt werden. ]

Ändert den Namen des angegebenen Registrierungsschlüssels.

Syntax

__kernel_entry NTSTATUS NtRenameKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING NewName
);

Parameter

[in] KeyHandle

Ein Handle für den umzubenennten Schlüssel. Das Handle muss mit dem zugriffsrecht KEY_WRITE geöffnet werden.

[in] NewName

Ein Zeiger auf eine UNICODE-Zeichenfolge, die den neuen Namen für den Schlüssel darstellt.

Rückgabewert

Gibt einen NTSTATUS- oder Fehlercode zurück. Ein Fehlercode von STATUS_ACCESS_DENIED gibt an, dass der Aufrufer nicht über die erforderlichen Zugriffsrechte auf den angegebenen Registrierungsschlüssel oder die angegebenen Unterschlüssel verfügt.

Die Formen und die Bedeutung von NTSTATUS-Fehlercodes sind in der Im WDK verfügbaren Ntstatus.h-Headerdatei aufgeführt und in der WDK-Dokumentation beschrieben.

Hinweise

Diese Funktion verfügt über keine zugeordnete Headerdatei. Sie können auch die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Ntdll.dll.

Die NtRenameKey-Funktion kann verwendet werden, um eine gesamte Registrierungsunterstruktur umzubenennen. Der Aufrufer muss KEY_CREATE_SUB_KEY Zugriff auf das übergeordnete Element des angegebenen Schlüssels und DELETE-Zugriff auf die gesamte umbenannte Unterstruktur haben.

Anforderungen

Weitere Informationen

Sicherheit und Zugriffsrechte für Registrierungsschlüssel