ISecurityInformation::SetSecurity-Methode (aclui.h)
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.
[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 |