RegDeleteKeyTransactedA-Funktion (winreg.h)

Löscht einen Unterschlüssel und seine Werte aus der angegebenen plattformspezifischen Ansicht der Registrierung als transacted-Vorgang. Beachten Sie, dass bei Schlüsselnamen die Groß-/Kleinschreibung nicht beachtet wird.

Syntax

LSTATUS RegDeleteKeyTransactedA(
  [in] HKEY   hKey,
  [in] LPCSTR lpSubKey,
  [in] REGSAM samDesired,
       DWORD  Reserved,
  [in] HANDLE hTransaction,
       PVOID  pExtendedParameter
);

Parameter

[in] hKey

Ein Handle zu einem geöffneten Registrierungsschlüssel. Die Zugriffsrechte dieses Schlüssels wirken sich nicht auf den Löschvorgang aus. Weitere Informationen zu Zugriffsrechten finden Sie unter Registry Key Security and Access Rights.

Dieses Handle wird von der RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyExoder RegOpenKeyTransacted Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüsselsein:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in] lpSubKey

Der Name des zu löschenden Schlüssels. Dieser Schlüssel muss ein Unterschlüssel des Schlüssels sein, der durch den Wert des hKey--Parameters angegeben wird.

Die Funktion öffnet den Unterschlüssel mit dem DELETE-Zugriffsrecht.

Bei Schlüsselnamen wird die Groß-/Kleinschreibung nicht beachtet.

Der Wert dieses Parameters kann nicht NULL-werden.

[in] samDesired

Ein Zugriffsformat, das die plattformspezifische Ansicht der Registrierung angibt.

Reserved

Dieser Parameter ist reserviert und muss null sein.

[in] hTransaction

Ein Handle zu einer aktiven Transaktion. Dieses Handle wird von der CreateTransaction--Funktion zurückgegeben.

pExtendedParameter

Dieser Parameter ist reserviert und muss NULL-sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist. Sie können die FormatMessage--Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine allgemeine Beschreibung des Fehlers zu erhalten.

Bemerkungen

Ein gelöschter Schlüssel wird erst entfernt, wenn der letzte Handle geschlossen wird.

Auf WOW64 zeigen 32-Bit-Anwendungen eine Registrierungsstruktur an, die von der Registrierungsstruktur getrennt ist, die 64-Bit-Anwendungen anzeigen. Mit dieser Funktion kann eine Anwendung einen Eintrag in der alternativen Registrierungsansicht löschen.

Der zu löschende Unterschlüssel darf keine Unterschlüssel enthalten. Um einen Schlüssel und alle zugehörigen Unterschlüssel zu löschen, müssen Sie die Unterschlüssel aufzählen und einzeln löschen. Um Schlüssel rekursiv zu löschen, verwenden Sie die RegDeleteTree- oder SHDeleteKey--Funktion.

Wenn die Funktion erfolgreich ist, entfernt RegDeleteKeyTransacted den angegebenen Schlüssel aus der Registrierung. Der gesamte Schlüssel, einschließlich aller Werte, wird entfernt. Um die gesamte Struktur als Transacted-Vorgang zu entfernen, verwenden Sie die RegDeleteTree Funktion mit einem Handle, das von RegCreateKeyTransacted oder RegOpenKeyTransactedzurückgegeben wird.

Anforderungen

Siehe auch

RegCreateKeyTransacted-

RegOpenKeyTransacted-

Registrierungsfunktionen

Registrierungsumleitung