GetAclInformation 함수(securitybaseapi.h)

아티클
03/05/2024

GetAclInformation 함수는 ACL(액세스 제어 목록)에 대한 정보를 검색합니다.

구문

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

매개 변수

[in] pAcl

ACL에 대한 포인터입니다. 함수는 이 ACL에 대한 정보를 검색합니다. null 값이 전달되면 함수는 액세스 위반을 발생합니다.

[out] pAclInformation

요청된 정보를 수신할 버퍼에 대한 포인터입니다. 버퍼에 배치되는 구조체는 dwAclInformationClass 매개 변수에서 요청된 정보 클래스에 따라 달라집니다.

[in] nAclInformationLength

pAclInformation 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

[in] dwAclInformationClass

요청된 정보의 클래스를 나타내는 ACL_INFORMATION_CLASS 열거형의 값입니다. 이 매개 변수는 이 열거형의 두 값 중 하나일 수 있습니다.

값이 AclRevisionInformation인 경우 함수는 pAclInformation 매개 변수가 가리키는 버퍼를 ACL_REVISION_INFORMATION 구조체로 채웁니다.
값이 AclSizeInformation인 경우 함수는 pAclInformation 매개 변수가 가리키는 버퍼를 ACL_SIZE_INFORMATION 구조체로 채웁니다.

반환 값

함수가 성공하면 함수는 0이 아닌 값을 반환합니다.

함수가 실패하면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	securitybaseapi.h(Windows.h 포함)
라이브러리	Advapi32.lib
DLL	Advapi32.dll