다음을 통해 공유


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
CIMWin32.mof
DLL
CIMWin32.dll

추가 정보

CIM_DataFile

CIM_DataFile

WMI 작업: 파일 및 폴더

파일 및 디렉터리 액세스 권한 상수