Freigeben über


SetAclInformation-Funktion (securitybaseapi.h)

Die SetAclInformation-Funktion legt Informationen zu einer Zugriffssteuerungsliste (Access Control List , ACL) fest.

Syntax

BOOL SetAclInformation(
  [in, out] PACL                  pAcl,
  [in]      LPVOID                pAclInformation,
  [in]      DWORD                 nAclInformationLength,
  [in]      ACL_INFORMATION_CLASS dwAclInformationClass
);

Parameter

[in, out] pAcl

Ein Zeiger auf eine ACL. Die Funktion legt Informationen in dieser ACL fest.

[in] pAclInformation

Ein Zeiger auf einen Puffer, der die festzulegenden Informationen enthält. Dies muss ein Zeiger auf eine ACL_REVISION_INFORMATION Struktur sein.

[in] nAclInformationLength

Die Größe des Puffers in Bytes, auf die der pAclInfo-Parameter verweist.

[in] dwAclInformationClass

Ein ACL_INFORMATION_CLASS aufgezählter Typ, der die Klasse der angeforderten Informationen angibt.

Derzeit kann dieser Parameter AclRevisionInformation sein. Dies bedeutet, dass der Puffer, auf den der pAclInformation-Parameter verweist, eine ACL_REVISION_INFORMATION-Struktur enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile securitybaseapi.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

GetAclInformation

InitializeAcl

IsValidAcl

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene