SetAclInformation-Funktion (securitybaseapi.h)

Artikel
08/25/2023

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