GetAce 함수(securitybaseapi.h)

GetAce 함수는 ACL(액세스 제어 목록)에서 ACE(액세스 제어 항목)에 대한 포인터를 가져옵니다.

구문

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

매개 변수

[in] pAcl

검색할 ACE가 포함된 ACL에 대한 포인터입니다.

[in] dwAceIndex

검색할 ACE의 인덱스입니다. 값이 0이면 ACL의 첫 번째 ACE, 1~2번째 ACE 값 등에 해당합니다.

[out] pAce

함수가 ACE의 주소로 설정하는 포인터에 대한 포인터입니다.

반환 값

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

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

요구 사항

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

추가 정보

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

하위 수준 Access Control

하위 수준 Access Control 함수