Freigeben über


RegSetKeySecurity-Funktion (winreg.h)

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

Weitere Informationen

FormatMessage

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene

RegCloseKey

RegDeleteKey

RegGetKeySecurity

SECURITY_DESCRIPTOR

SECURITY_INFORMATION