EditSecurity-Funktion (aclui.h)

Artikel
02/23/2024

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