GetSecurityDescriptorGroup 함수(securitybaseapi.h)

아티클
08/25/2023

GetSecurityDescriptorGroup 함수는 보안 설명자에서 기본 그룹 정보를 검색합니다.

구문

BOOL GetSecurityDescriptorGroup(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pGroup,
  [out] LPBOOL               lpbGroupDefaulted
);

매개 변수

[in] pSecurityDescriptor

함수가 검색하는 기본 그룹 정보가 있는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

[out] pGroup

함수가 반환되는 경우 기본 그룹을 식별하는 SID( 보안 식별자 )에 대한 포인터입니다. 보안 설명자에 기본 그룹이 없는 경우 함수는 pGroup 이 가리키는 포인터를 NULL 로 설정하고 나머지 출력 매개 변수 인 lpbGroupDefaulted를 무시합니다. 보안 설명자에 기본 그룹이 포함된 경우 함수는 pGroup 이 가리키는 포인터를 보안 설명자 그룹 SID의 주소로 설정하고 lpbGroupDefaulted가 가리키는 변수에 유효한 값을 제공합니다.

[out] lpbGroupDefaulted

함수가 반환되는 경우 SECURITY_DESCRIPTOR_CONTROL 구조에서 SE_GROUP_DEFAULTED 플래그 값으로 설정된 플래그에 대한 포인터입니다. pGroup 매개 변수가 가리키는 변수에 저장된 값이 NULL이면 값이 설정되지 않습니다.

반환 값

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

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

요구 사항

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