SetAclInformation
The SetAclInformation
function sets information about an access-control list (ACL).
BOOL SetAclInformation(
|
PACL pAcl, |
// address of
access-control list |
|
LPVOID pAclInformation, |
// address of ACL
information |
|
DWORD nAclInformationLength, |
// size of ACL
information |
|
ACL_INFORMATION_CLASS dwAclInformationClass |
// specifies class
of requested info |
|
); |
|
Parameters
pAcl
Points to an ACL structure. The function
sets information in this ACL.
pAclInformation
Points to a
buffer containing the information to be set. For the current version of Windows
NT, this must be an ACL_REVISION_INFORMATION structure.
nAclInformationLength
Specifies the
size, in bytes, of the buffer pointed to by the pAclInfo parameter.
dwAclInformationClass
Specifies 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 Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
See Also