ISecurityInformation::GetSecurity-Methode (aclui.h)
Die GetSecurity-Methode fordert einen Sicherheitsdeskriptor für das sicherungsfähige Objekt an, dessen Sicherheitsdeskriptor bearbeitet wird. Der Zugriffssteuerungs-Editor ruft diese Methode auf, um die aktuelle oder standardsicherheitsdeskriptor des Objekts abzurufen.
Syntax
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
Parameter
[in] RequestedInformation
Eine Reihe von SECURITY_INFORMATION Bitflags, die die angeforderten Teile des Sicherheitsdeskriptors angeben. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.
[out] ppSecurityDescriptor
Ein Zeiger auf eine Variable, die Ihre Implementierung auf einen Zeiger auf die Sicherheitsbeschreibung des Objekts festlegen muss. Die Sicherheitsbeschreibung muss die vom Parameter RequestedInformation angeforderten Komponenten enthalten.
Das System ruft die LocalFree-Funktion auf, um den zurückgegebenen Zeiger freizugeben.
[in] fDefault
Wenn dieser Parameter TRUE ist, sollte ppSecurityDescriptor einen von der Anwendung definierten Standardsicherheitsdeskriptor für das Objekt zurückgeben. Der Zugriffssteuerungs-Editor verwendet diesen Standardsicherheitsdeskriptor, um die Eigenschaftenseite neu zu initialisieren.
Der Zugriffssteuerungs-Editor legt diesen Parameter nur auf TRUE fest, wenn der Benutzer auf die Schaltfläche Standard klickt. Die Standardschaltfläche wird nur angezeigt, wenn Sie das SI_RESET-Flag in der ISecurityInformation::GetObjectInformation-Methode festlegen. Wenn keine Standardsicherheitsbeschreibung verfügbar ist, legen Sie nicht das flag SI_RESET fest.
Wenn dieses Flag FALSE ist, sollte ppSecurityDescriptor den aktuellen Sicherheitsdeskriptor des Objekts zurückgeben.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück.
Gibt einen fehlerfreien Fehlercode zurück, wenn ein Fehler auftritt. Gibt E_ACCESSDENIED zurück, wenn der Benutzer nicht über die Berechtigung zum Lesen der angeforderten Sicherheitsinformationen verfügt.
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 |
Weitere Informationen
Access Control Editorfunktionen