SetFileSecurityA 함수(winbase.h)

아티클
08/27/2023

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

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

구문

BOOL SetFileSecurityA(
  [in] LPCSTR               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
헤더	winbase.h(Windows.h 포함)
라이브러리	Advapi32.lib
DLL	Advapi32.dll