RtlDeleteAce 함수(ntifs.h)

RtlDeleteAce 루틴은 지정된 ACL(액세스 제어 목록)에서 ACE(액세스 제어 항목)를 삭제합니다.

구문

NTSYSAPI NTSTATUS RtlDeleteAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceIndex
);

매개 변수

[in, out] Acl

수정할 ACL에 대한 포인터입니다. RtlDeleteAce 는 이 ACL에서 지정된 ACE를 삭제합니다.

[in] AceIndex

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

반환 값

RtlDeleteAce는 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드 설명
STATUS_INVALID_PARAMETER 매개 변수 값 중 하나가 잘못되었습니다.

STATUS_INVALID_PARAMETER 가능한 이유는 다음과 같습니다.

  • 지정된 ACL이 잘못되었습니다.
  • 지정된 인덱스 값이 범위를 벗어났습니다.
  • STATUS_INVALID_PARAMETER 오류 코드입니다.

설명

ACL 크기를 계산하는 방법에 대한 자세한 내용은 RtlCreateAcl에 대한 참조 항목의 설명 섹션을 참조하세요.

ACL에 ACE를 추가하려면 RtlAddAce를 사용합니다.

ACL에서 ACE에 대한 포인터를 가져오려면 RtlGetAce를 사용합니다.

보안 및 액세스 제어에 대한 자세한 내용은 드라이버 개발자를 위한 Windows 보안 모델 및 Windows SDK의 이러한 topics 대한 설명서를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Server 2003 SP1
대상 플랫폼 유니버설
헤더 ntifs.h(Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

추가 정보

에이스

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce