SetSecurityInfo 함수(aclapi.h)
SetSecurityInfo 함수는 지정된 개체의 보안 설명자에 지정된 보안 정보를 설정합니다. 호출자는 핸들로 개체를 식별합니다.
개체의 SACL을 설정하려면 호출자가 SE_SECURITY_NAME 권한을 사용하도록 설정해야 합니다.
구문
DWORD SetSecurityInfo(
[in] HANDLE handle,
[in] SE_OBJECT_TYPE ObjectType,
[in] SECURITY_INFORMATION SecurityInfo,
[in, optional] PSID psidOwner,
[in, optional] PSID psidGroup,
[in, optional] PACL pDacl,
[in, optional] PACL pSacl
);
매개 변수
[in] handle
보안 정보를 설정할 개체에 대한 핸들입니다.
[in] ObjectType
핸들 매개 변수로 식별되는 개체의 형식을 나타내는 SE_OBJECT_TYPE 열거형의 멤버입니다.
[in] SecurityInfo
설정할 보안 정보의 유형을 나타내는 비트 플래그 집합입니다. 이 매개 변수는 SECURITY_INFORMATION 비트 플래그의 조합일 수 있습니다.
[in, optional] psidOwner
개체의 소유자를 식별하는 SID에 대한 포인터입니다. SID는 보안 설명자의 소유자 SID로 할당할 수 있는 SID여야 합니다. SecurityInfo 매개 변수에는 OWNER_SECURITY_INFORMATION 플래그가 포함되어야 합니다. 소유자 SID를 설정하지 않는 경우 이 매개 변수는 NULL 일 수 있습니다.
[in, optional] psidGroup
개체의 기본 그룹을 식별하는 SID에 대한 포인터입니다. SecurityInfo 매개 변수에는 GROUP_SECURITY_INFORMATION 플래그가 포함되어야 합니다. 기본 그룹 SID를 설정하지 않는 경우 이 매개 변수는 NULL 일 수 있습니다.
[in, optional] pDacl
개체의 새 DACL에 대한 포인터입니다. SecurityInfo 매개 변수 값에 DACL_SECURITY_INFORMATION 플래그가 포함되어 있지 않으면 이 매개 변수는 무시됩니다. SecurityInfo 매개 변수 값에 DACL_SECURITY_INFORMATION 플래그가 포함되어 있고 이 매개 변수의 값이 NULL로 설정된 경우 개체에 대한 모든 권한이 모든 사용자에게 부여됩니다. null DACL에 대한 자세한 내용은 DACL 만들기를 참조하세요.
[in, optional] pSacl
개체의 새 SACL에 대한 포인터입니다. SecurityInfo 매개 변수에는 SACL_SECURITY_INFORMATION, LABEL_SECURITY_INFORMATION, ATTRIBUTE_SECURITY_INFORMATION, SCOPE_SECURITY_INFORMATION 또는 BACKUP_SECURITY_INFORMATION 플래그가 포함되어야 합니다. SACL_SECURITY_INFORMATION 또는 SCOPE_SECURITY_INFORMATION 설정하는 경우 호출자는 SE_SECURITY_NAME 권한을 사용하도록 설정해야 합니다. SACL을 설정하지 않는 경우 이 매개 변수는 NULL 일 수 있습니다.
반환 값
함수가 성공하면 함수는 ERROR_SUCCESS 반환합니다.
함수가 실패하면 WinError.h에 정의된 0이 아닌 오류 코드를 반환합니다.
설명
DACL(임의 액세스 제어 목록) 또는 개체의 SACL(시스템 액세스 제어 목록)에 있는 요소를 설정하는 경우 시스템은 ACE 상속 규칙에 따라 상속 가능한 모든 ACE(액세스 제어 항목)를 기존 자식 개체에 자동으로 전파합니다.
SetSecurityInfo 함수를 다음 유형의 개체와 함께 사용할 수 있습니다.
- NTFS의 로컬 또는 원격 파일 또는 디렉터리
- 명명된 파이프
- 로컬 또는 원격 프린터
- 로컬 또는 원격 Windows 서비스
- 네트워크 공유
- 레지스트리 키
- 세마포, 이벤트, 뮤텍스 및 대기 가능한 타이머
- 프로세스, 스레드, 작업 및 파일 매핑 개체
- 창 스테이션 및 데스크톱
- 디렉터리 서비스 개체
SetSecurityInfo 함수는 기본 순서에 따라 액세스 허용 또는 액세스 거부 API의 순서를 다시 지정하지 않습니다. 상속 가능한 ACE를 기존 자식 개체에 전파하는 경우 SetSecurityInfo 는 상속된 ACE를 자식 개체의 DACL에 있는 모든 상속되지 않은 ACL 다음에 순서대로 배치합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | aclapi.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |