SetFileSecurityW 함수(securitybaseapi.h)

SetFileSecurity 함수는 파일 또는 디렉터리 개체의 보안을 설정합니다.

이 함수는 사용되지 않습니다. 대신 SetNamedSecurityInfo 함수를 사용합니다.

구문

BOOL SetFileSecurityW(
  [in] LPCWSTR              lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

매개 변수

[in] lpFileName

보안이 설정된 파일 또는 디렉터리를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 디렉터리에 적용된 보안은 해당 자식에 의해 상속되지 않습니다.

[in] SecurityInformation

pSecurityDescriptor 매개 변수가 가리키는 보안 설명자의 내용을 식별하는 SECURITY_INFORMATION 구조를 지정합니다.

[in] pSecurityDescriptor

SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

반환 값

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

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

설명

SetFileSecurity 함수는 다음 조건이 충족되는 경우에만 성공합니다.

• 개체의 소유자가 설정되는 경우 호출 프로세스 에는 WRITE_OWNER 권한이 있거나 개체의 소유자여야 합니다.
• 개체의 DACL( 임의 액세스 제어 목록 )이 설정되는 경우 호출 프로세스에는 WRITE_DAC 권한이 있거나 개체의 소유자여야 합니다.
• 개체의 SACL( 시스템 액세스 제어 목록 )이 설정되는 경우 호출 프로세스에 대해 SE_SECURITY_NAME 권한을 사용하도록 설정해야 합니다.

요구 사항

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

추가 정보

GetFileSecurity
하위 수준 Access Control
하위 수준 Access Control 함수
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetKernelObjectSecurity
SetNamedSecurityInfoSetPrivateObjectSecurity
SetUserObjectSecurity