ISecurityInformation::SetSecurity-Methode (aclui.h)

Artikel
02/26/2024

Die SetSecurity-Methode stellt einen Sicherheitsdeskriptor bereit, der die Sicherheitsinformationen enthält, die der Benutzer auf das sicherungsfähige Objekt anwenden möchte. Der Zugriffssteuerungs-Editor ruft diese Methode auf, wenn der Benutzer auf Ok oder Anwenden klickt.

Syntax

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] SecurityInformation

Ein Satz von SECURITY_INFORMATION Bitflags, die die festzulegenden Teile des Sicherheitsdeskriptors angeben. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
OWNER_SECURITY_INFORMATION	Die Sicherheitsbeschreibung enthält die SID des Besitzers des Objekts.
GROUP_SECURITY_INFORMATION	Die Sicherheitsbeschreibung enthält die SID der primären Gruppe des Objekts.
DACL_SECURITY_INFORMATION	Der Sicherheitsdeskriptor enthält die DACL des Objekts.
SACL_SECURITY_INFORMATION	Die Sicherheitsbeschreibung enthält die SACL des Objekts.

[in] pSecurityDescriptor

Ein Zeiger auf einen Sicherheitsdeskriptor, der die neuen Sicherheitsinformationen enthält. Gehen Sie nicht davon aus, dass der Sicherheitsdeskriptor eine selbstrelative Form aufweist. sie kann entweder absolut oder selbstrelativer Sein.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück.

Gibt einen Fehlercode ungleich null zurück, wenn ein Fehler auftritt.

Hinweise

Um einen vollständigen Sicherheitsdeskriptor für das Objekt zu erstellen, muss die Anwendung die neuen Sicherheitsdeskriptorteile, wie durch den SecurityInformation-Parameter definiert, mit dem vorhandenen Sicherheitsdeskriptor des Objekts zusammenführen.

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	aclui.h

Weitere Informationen

Access Control-Editor

funktionen des Access Control-Editors

ISecurityInformation

SECURITY_INFORMATION

Freigeben über