CreateSecurityPage-Funktion (aclui.h)

Artikel
02/23/2024

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