RtlGetGroupSecurityDescriptor 함수(ntifs.h)
RtlGetGroupSecurityDescriptor 루틴은 지정된 보안 설명자에 대한 기본 그룹 정보를 반환합니다.
구문
NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR SecurityDescriptor,
[out] PSID *Group,
[out] PBOOLEAN GroupDefaulted
);
매개 변수
[in] SecurityDescriptor
기본 그룹 정보를 반환할 보안 설명자에 대한 포인터입니다.
[out] Group
기본 그룹의 SID(보안 식별자)에 대한 포인터를 받는 변수에 대한 포인터입니다. 보안 설명자에 기본 그룹이 없는 경우 *그룹은NULL을 받습니다.
[out] GroupDefaulted
보안 설명자의 SECURITY_DESCRIPTOR_CONTROL 구조에서 SE_GROUP_DEFAULTED 플래그 값을 받는 부울 변수에 대한 포인터입니다. 이 값은 *Group 이 NULL 이 아닌 값을 받는 경우에만 유효합니다.
반환 값
RtlGetGroupSecurityDescriptor 는 STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
보안 설명자의 수정 버전을 알 수 없거나 지원되지 않습니다. 오류 코드입니다. |
설명
SecurityDescriptor가 가리키는 보안 설명자에 기본 그룹이 포함된 경우 RtlGetGroupSecurityDescriptor는 Group이 가리키는 포인터를 보안 설명자의 그룹 SID 주소로 설정하고 GroupDefaulted가 가리키는 변수를 유효한 값으로 설정합니다.
SecurityDescriptor가 가리키는 보안 설명자에 기본 그룹이 없는 경우 RtlGetGroupSecurityDescriptor는 Group이 가리키는 포인터를 NULL로 설정하고 나머지 출력 매개 변수 GroupDefaulted를 무시합니다.
보안 설명자에 대한 기본 그룹 정보를 설정하려면 RtlSetGroupSecurityDescriptor를 사용합니다.
보안 설명자에 대한 소유자 정보를 검색하려면 RtlGetOwnerSecurityDescriptor를 사용합니다.
보안 및 액세스 제어에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Server 2003 SP1 |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntifs.h(Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |