RegSetKeySecurity-Funktion (winreg.h)

Artikel
08/27/2023

Die RegSetKeySecurity-Funktion legt die Sicherheit eines geöffneten Registrierungsschlüssels fest.

Syntax

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] hKey

Ein Handle für einen geöffneten Schlüssel, für den die Sicherheitsbeschreibung festgelegt ist.

[in] SecurityInformation

Eine Reihe von Bitflags, die den Typ der festzulegenden Sicherheitsinformationen angeben. Dieser Parameter kann eine Kombination der SECURITY_INFORMATION Bitflags sein.

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die die Sicherheitsattribute angibt, die für den angegebenen Schlüssel festgelegt werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen nichtzero-Fehlercode zurück, der in WinError.h definiert ist. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Hinweise

Wenn hKey einer der vordefinierten Schlüssel ist, verwenden Sie die RegCloseKey-Funktion , um den vordefinierten Schlüssel zu schließen, um sicherzustellen, dass die neuen Sicherheitsinformationen beim nächsten Verweis auf den vordefinierten Schlüssel wirksam sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winreg.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll