DeleteAce 함수(securitybaseapi.h)

DeleteAce 함수는 ACL(액세스 제어 목록)에서 ACE(액세스 제어 항목)를 삭제합니다.

구문

BOOL DeleteAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceIndex
);

[in, out] pAcl

ACL에 대한 포인터입니다. dwAceIndex 매개 변수로 지정된 ACE가 이 ACL에서 제거됩니다.

[in] dwAceIndex

삭제할 ACE입니다. 값 0은 ACL의 첫 번째 ACE, 두 번째 ACE에 대한 값 등에 해당합니다.

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

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

애플리케이션은 GetAclInformation 함수에서 검색한 ACL_SIZE_INFORMATION 구조를 사용하여 ACL의 크기와 ACL에 포함된 API 수를 검색할 수 있습니다. GetAce 함수는 개별 ACE에 대한 정보를 검색합니다.

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