SetAclInformation function
The SetAclInformation function sets information about an access control list (ACL).
Syntax
BOOL WINAPI SetAclInformation( _Inout_ PACL pAcl, _In_ LPVOID pAclInformation, _In_ DWORD nAclInformationLength, _In_ ACL_INFORMATION_CLASS dwAclInformationClass );
Parameters
- pAcl [in, out]
-
A pointer to an ACL. The function sets information in this ACL.
- pAclInformation [in]
-
A pointer to a buffer that contains the information to be set. This must be a pointer to an ACL_REVISION_INFORMATION structure.
- nAclInformationLength [in]
-
The size, in bytes, of the buffer pointed to by the pAclInfo parameter.
- dwAclInformationClass [in]
-
An ACL_INFORMATION_CLASS enumerated type that gives the class of information requested.
Currently, this parameter can be AclRevisionInformation. This means that the buffer pointed to by the pAclInformation parameter contains an ACL_REVISION_INFORMATION structure.
Return value
If the function succeeds, the function returns nonzero.
If the function fails, it returns zero. To get extended error information, call GetLastError.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Low-level Access Control
- Low-level Access Control Functions
- ACL_INFORMATION_CLASS
- ACL_REVISION_INFORMATION
- GetAclInformation
- InitializeAcl
- IsValidAcl