EditSecurity-Funktion (aclui.h)
Die EditSecurity-Funktion zeigt ein Eigenschaftenblatt an, das eine grundlegende Seite für Sicherheitseigenschaften enthält. Auf dieser Eigenschaftenseite kann der Benutzer die Zugriffsrechte anzeigen und bearbeiten, die von den ACEs in der DACL eines Objekts zugelassen oder verweigert werden.
Syntax
BOOL ACLUIAPI EditSecurity(
[in] HWND hwndOwner,
[in] LPSECURITYINFO psi
);
Parameter
[in] hwndOwner
Ein Handle für das Fenster, das das Eigenschaftenblatt besitzt. Dieser Parameter kann NULL sein.
[in] psi
Ein Zeiger auf Ihre Implementierung der ISecurityInformation-Schnittstelle . Das System ruft die Schnittstellenmethoden auf, um Informationen über das zu bearbeitende Objekt abzurufen und die Eingabe des Benutzers zurückzugeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die EditSecurity-Funktion ruft die CreateSecurityPage-Funktion auf, um eine grundlegende Seite für Sicherheitseigenschaften zu erstellen.
Während der Initialisierung der Eigenschaftenseite ruft das System die Methoden ISecurityInformation::GetSecurity und ISecurityInformation::SetSecurity auf, um zu bestimmen, ob der Benutzer über die Berechtigung zum Bearbeiten des Sicherheitsdeskriptors des Objekts verfügt. Das System zeigt eine Fehlermeldung an, wenn der Benutzer nicht über die Berechtigung verfügt.
Die Seite mit den grundlegenden Sicherheitseigenschaften kann eine Schaltfläche Erweitert zum Anzeigen des Erweiterten Sicherheitseigenschaftenblatts enthalten. Dieses erweiterte Sicherheitseigenschaftenblatt kann drei zusätzliche Eigenschaftenseiten enthalten, die es dem Benutzer ermöglichen, die DACL, SACL und besitzer des Objekts anzuzeigen und zu bearbeiten.
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 |
| Bibliothek | Aclui.lib |
| DLL | Aclui.dll |