CIM_DataFile 클래스의 ChangeSecurityPermissionsEx 메서드
ChangeSecurityPermissionsEx 메서드는 개체 경로에 지정된 논리 데이터 파일에 대한 보안 권한을 변경합니다(이 메서드는 ChangeSecurityPermissions 메서드의 확장 버전임). 논리 파일이 실제로 디렉터리인 경우 이 메서드는 재귀적으로 작동하여 디렉터리에 포함된 모든 파일 및 하위 디렉터리에 대한 보안 권한을 변경합니다.
중요
DMTF(분산 관리 태스크 포스) CIM(일반 정보 모델) 클래스는 WMI 클래스를 빌드하는 부모 클래스입니다. WMI는 현재 CIM 2.x 버전 스키마만 지원합니다.
이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조하세요.
구문
uint32 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
매개 변수
-
SecurityDescriptor [in]
-
보안 정보를 지정합니다.
참고
SECURITY_DESCRIPTOR 구조의 NULL ACL은 무제한 액세스 권한을 부여합니다. 무제한 액세스의 의미에 대한 자세한 내용은 새 개체에 대한 보안 설명자 만들기를 참조하세요.
-
옵션 [in]
-
수정할 보안 권한입니다. 예를 들어 소유자 및 DACL 보안을 변경하려면 다음을 사용합니다.
Option = 1 + 4또는Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
CHANGE_OWNER_SECURITY_INFORMATION (1)
-
논리 파일의 소유자를 변경합니다.
-
CHANGE_GROUP_SECURITY_INFORMATION (2)
-
논리 파일의 그룹을 변경합니다.
-
CHANGE_DACL_SECURITY_INFORMATION (4)
-
논리 파일의 ACL을 변경합니다.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
논리 파일의 시스템 ACL을 변경합니다.
StopFileName [out]
메서드가 실패한 파일(또는 디렉터리)의 이름을 나타내는 문자열입니다. 메서드가 성공하면 이 매개 변수는 null 입니다.
StartFileName [in, optional]
이 메서드의 시작점으로 사용할 자식 파일(또는 디렉터리)을 나타내는 문자열입니다. 일반적으로 StartFileName 매개 변수는 이전 메서드 호출에서 오류가 발생한 파일 또는 디렉터리를 지정하는 StopFileName 매개 변수입니다. 이 매개 변수가 null이면 ExecMethod 호출에 지정된 파일(또는 디렉터리)에서 작업이 수행됩니다.
StartFileName을 사용하는 경우 재귀도 true로 설정해야 합니다.
재귀 [in, 선택 사항]
True이면 메서드가 CIM_DataFile instance 지정된 디렉터리 내의 파일 및 디렉터리에 재귀적으로 적용됩니다. 파일 인스턴스의 경우 이 매개 변수는 무시됩니다.
반환 값
성공하면 값 0을 반환하고 오류를 나타내는 다른 숫자를 반환합니다. 추가 오류 코드는 WMI 오류 상수 또는 WbemErrorEnum을 참조하세요. 일반적인 HRESULT 값은시스템 오류 코드를 참조하세요.
-
Success
-
0
성공했습니다.
-
액세스 거부됨
-
2
액세스가 거부되었습니다.
-
지정되지 않은 오류
-
8
지정되지 않은 오류입니다.
-
잘못된 개체
-
9
지정한 개체 이름이 잘못되었습니다.
-
개체가 이미 있음
-
10
개체가 이미 있습니다.
-
NTFS가 아닌 파일 시스템
-
11
NTFS가 아닌 파일 시스템입니다.
-
플랫폼이 NT/Windows 2000이 아님
-
12
플랫폼이 Windows가 아닙니다.
-
드라이브가 동일하지 않음
-
13
드라이브가 동일하지 않습니다.
-
디렉터리가 비어 있음
-
14
디렉터리가 비어 있지 않습니다.
-
공유 위반
-
15
공유 위반입니다.
-
잘못된 시작 파일
-
16
시작 파일이 잘못되었습니다.
-
권한이 부여되지 않음
-
17
권한이 없습니다.
-
잘못된 매개 변수
-
21
매개 변수가 잘못된 경우
설명
CIM_DataFileChangeSecurityPermissionsEx 메서드는 WMI에 의해 구현됩니다.
이 설명서는 DMTF에서 게시한 CIM 클래스 설명을 바탕으로 합니다. Microsoft에서 사소한 오류를 수정하거나, Microsoft SDK 설명서 표준을 준수하거나, 자세한 정보를 제공하기 위해 내용을 변경했을 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 네임스페이스 |
Root\CIMV2 |
| MOF |
|
| DLL |
|