Export (0) Print
Expand All
Expand Minimize

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

Winbase.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

Low-level Access Control
Low-level Access Control Functions
ACL_INFORMATION_CLASS
ACL_REVISION_INFORMATION
GetAclInformation
InitializeAcl
IsValidAcl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft