SetSecurityDescriptorGroup 함수(securitybaseapi.h)

아티클
08/25/2023

SetSecurityDescriptorGroup 함수는 절대 형식 보안 설명자의 기본 그룹 정보를 설정하여 보안 설명자에 이미 있는 모든 기본 그룹 정보를 대체합니다.

구문

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

매개 변수

[in, out] pSecurityDescriptor

이 함수에 의해 기본 그룹이 설정된 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 함수는 기존 주 그룹을 새 주 그룹으로 바꿉니다.

[in, optional] pGroup

보안 설명자의 새 기본 그룹에 대한 SID 구조에 대한 포인터입니다. SID 구조는 보안 설명자에 복사되지 않고 에서 참조됩니다. 이 매개 변수가 NULL이면 함수는 보안 설명자의 기본 그룹 정보를 지웁니다. 이렇게 하면 보안 설명자가 기본 그룹이 없는 것으로 표시됩니다.

[in] bGroupDefaulted

기본 그룹 정보가 기본 메커니즘에서 파생되었는지 여부를 나타냅니다. 이 값이 TRUE이면 기본 정보이며 함수는 이 값을 SECURITY_DESCRIPTOR_CONTROL 구조체 의 SE_GROUP_DEFAULTED 플래그로 저장합니다. 이 매개 변수가 0이면 SE_GROUP_DEFAULTED 플래그가 지워집니다.

반환 값

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

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

요구 사항

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