SetKernelObjectSecurity-Funktion (securitybaseapi.h)

Artikel
03/04/2024

Die SetKernelObjectSecurity-Funktion legt die Sicherheit eines Kernelobjekts fest. Dies kann z. B. ein Prozess, ein Thread oder ein Ereignis sein.

Hinweis Diese Funktion sollte beim Festlegen eines Sicherheitsdeskriptors für Dateisystemobjekte nicht verwendet werden. Verwenden Sie stattdessen die Funktionen SetSecurityInfo oder SetNamedSecurityInfo .

Syntax

BOOL SetKernelObjectSecurity(
  [in] HANDLE               Handle,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parameter

[in] Handle

Ein Handle für ein Kernelobjekt, für das Sicherheitsinformationen festgelegt sind.

[in] SecurityInformation

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

[in] SecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die die neuen Sicherheitsinformationen enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll