SetSecurityDescriptorControl 함수(securitybaseapi.h)

아티클
03/15/2023

SetSecurityDescriptorControl 함수는 보안 설명자의 컨트롤 비트를 설정합니다. 함수는 ACE의 자동 상속과 관련된 컨트롤 비트만 설정할 수 있습니다. 보안 설명자의 다른 컨트롤 비트를 설정하려면 SetSecurityDescriptorDacl과 같은 함수를 사용하여 보안 설명자의 구성 요소를 수정합니다.

구문

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

매개 변수

[in] pSecurityDescriptor

컨트롤 및 수정 정보가 설정된 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

[in] ControlBitsOfInterest

설정할 컨트롤 비트를 나타내는 SECURITY_DESCRIPTOR_CONTROL 마스크입니다.

[in] ControlBitsToSet

ControlBitsOfInterest 마스크로 지정된 컨트롤 비트의 새 값을 나타내는 SECURITY_DESCRIPTOR_CONTROL 마스크입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

SetSecurityDescriptorControl 함수는 수정할 컨트롤 비트 또는 비트와 비트가 켜지거나 꺼져 있는지 여부를 지정합니다.

예제

다음 예제에서는 보안 설명자의 DACL을 보호됨으로 표시합니다.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

다음 예제에서는 DACL을 보호되지 않음으로 표시합니다.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

요구 사항


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