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