Skip to content

Latest commit

 

History

History
131 lines (87 loc) · 4.15 KB

nf-securitybaseapi-getaclinformation.md

File metadata and controls

131 lines (87 loc) · 4.15 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:securitybaseapi.GetAclInformation
GetAclInformation function (securitybaseapi.h)
Retrieves information about an access control list (ACL).
GetAclInformation
GetAclInformation function [Security]
_win32_getaclinformation
security.getaclinformation
securitybaseapi/GetAclInformation
security\getaclinformation.htm
security
23ef6abd-03e9-439e-ba05-629c8d61cd66
12/05/2018
GetAclInformation, GetAclInformation function [Security], _win32_getaclinformation, security.getaclinformation, securitybaseapi/GetAclInformation
securitybaseapi.h
Windows.h
Windows
Windows XP [desktop apps \| UWP apps]
Windows Server 2003 [desktop apps \| UWP apps]
Advapi32.lib
Advapi32.dll
Windows
19H1
GetAclInformation
securitybaseapi/GetAclInformation
c++
APIRef
kbSyntax
DllExport
Advapi32.dll
API-MS-Win-DownLevel-AdvApi32-l1-1-0.dll
KernelBase.dll
API-MS-Win-DownLevel-AdvApi32-l1-1-1.dll
API-MS-Win-Security-base-l1-1-0.dll
API-MS-Win-Security-base-l1-2-0.dll
MinKernelBase.dll
API-MS-Win-Security-Base-L1-2-1.dll
GetAclInformation

GetAclInformation function

-description

The GetAclInformation function retrieves information about an access control list (ACL).

-parameters

-param pAcl [in]

A pointer to an ACL. The function retrieves information about this ACL. If a null value is passed, the function causes an access violation.

-param pAclInformation [out]

A pointer to a buffer to receive the requested information. The structure that is placed into the buffer depends on the information class requested in the dwAclInformationClass parameter.

-param nAclInformationLength [in]

The size, in bytes, of the buffer pointed to by the pAclInformation parameter.

-param dwAclInformationClass [in]

A value of the ACL_INFORMATION_CLASS enumeration that indicates the class of information requested. This parameter can be one of two values from this enumeration:

  • If the value is AclRevisionInformation, the function fills the buffer pointed to by the pAclInformation parameter with an ACL_REVISION_INFORMATION structure.
  • If the value is AclSizeInformation, the function fills the buffer pointed to by the pAclInformation parameter with an ACL_SIZE_INFORMATION structure.

-returns

If the function succeeds, the function returns nonzero.

If the function fails, it returns zero. To get extended error information, call GetLastError.

-see-also

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

ACL_SIZE_INFORMATION

GetAce

InitializeAcl

IsValidAcl

Low-level Access Control

Low-level Access Control Functions

SetAclInformation