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 |