InitializeSecurityDescriptor 함수(securitybaseapi.h)

아티클
08/25/2023

InitializeSecurityDescriptor 함수는 새 보안 설명자를 초기화합니다.

구문

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

매개 변수

[out] pSecurityDescriptor

함수가 초기화하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

[in] dwRevision

보안 설명자에 할당할 수정 수준입니다. 이 매개 변수는 SECURITY_DESCRIPTOR_REVISION 합니다.

반환 값

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

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

설명

InitializeSecurityDescriptor 함수는 자체 상대 형식이 아닌 절대 형식으로 보안 설명자를 초기화합니다.

InitializeSecurityDescriptor 함수는 보안 설명자를 초기화하여 SACL(시스템 액세스 제어 목록), DACL(임의 액세스 제어 목록), 소유자 없음, 기본 그룹 및 모든 컨트롤 플래그를 FALSE(NULL)로 설정하지 않습니다. 따라서 수정 수준을 제외하고 비어 있습니다.

예제

이 함수를 사용하는 예제는 새 개체에 대한 보안 설명자 만들기를 참조하세요.

요구 사항


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