CreateSecurityPage-Funktion (aclui.h)
Die CreateSecurityPage-Funktion erstellt eine grundlegende Sicherheitseigenschaftenseite , die es dem Benutzer ermöglicht, die Zugriffsrechte anzuzeigen und zu bearbeiten, die von den Zugriffssteuerungseinträgen (Access Control Entries , ACEs) in der diskretionären Zugriffssteuerungsliste (DACL) eines Objekts zugelassen oder verweigert werden. Verwenden Sie die PropertySheet-Funktion oder die PSM_ADDPAGE Meldung, um diese Seite einem Eigenschaftenblatt hinzuzufügen.
Syntax
HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
[in] LPSECURITYINFO psi
);
Parameter
[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, gibt die Funktion ein Handle an eine grundlegende Seite der Sicherheitseigenschaften zurück.
Wenn bei der Funktion ein Fehler auftritt, gibt sie NULL zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
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 der Sicherheitsbeschreibung des Objekts verfügt. Das System zeigt eine Fehlermeldung an, wenn der Benutzer nicht über die Berechtigung verfügt.
Die Seite "Grundlegende Sicherheitseigenschaften" kann eine Schaltfläche "Erweitert " zum Anzeigen des Blatts "Erweiterte Sicherheitseigenschaften" enthalten. Dieses erweiterte Sicherheitseigenschaftenblatt kann drei zusätzliche Eigenschaftenseiten enthalten, die es dem Benutzer ermöglichen, die DACL, die Systemzugriffssteuerungsliste (System Access Control List , SACL) und den 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 |