CIM_Directory 클래스의 TakeOwnerShipEx 메서드

TakeOwnerShipEx 메서드는 개체 경로에 지정된 논리 디렉터리 항목 파일의 소유권을 가져옵니다. 이 메서드는 TakeOwnerShip 메서드의 확장 버전이며 CIM_LogicalFile 상속됩니다. 논리 파일이 디렉터리인 경우 이 메서드는 재귀적으로 작동하여 디렉터리에 포함된 모든 파일 및 하위 디렉터리의 소유권을 갖습니다.

이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조하세요.

구문

uint32 TakeOwnerShipEx(
  [out] string REF StopFileName,
  [in]  string     StartFileName,
  [in]  boolean    Recursive
);

매개 변수

StopFileName [out]

메서드가 실패한 파일(또는 디렉터리)의 이름을 나타내는 문자열입니다. 메서드가 성공하면 이 매개 변수는 null입니다.

StartFileName [in]

이 메서드의 시작점으로 사용할 자식 파일(또는 디렉터리)을 나타내는 문자열입니다. 일반적으로 이 매개 변수는 이전 메서드 호출에서 오류가 발생한 파일 또는 디렉터리를 지정하는 StopFileName 매개 변수입니다. 이 매개 변수가 null이면 ExecMethod 호출에 지정된 파일(또는 디렉터리)에서 작업이 수행됩니다.

재귀 [in]

True이면 메서드가 CIM_Directory instance 지정된 디렉터리 내의 파일 및 디렉터리에 재귀적으로 적용됩니다. 파일 인스턴스의 경우 이 매개 변수는 무시됩니다.

반환 값

성공하면 값 0을 반환하고 오류를 나타내는 다른 숫자를 반환합니다.

0

성공했습니다.

2

액세스가 거부되었습니다.

8

지정되지 않은 오류입니다.

9

개체가 잘못되었습니다.

10

개체가 이미 있습니다.

11

NTFS가 아닌 파일 시스템입니다.

12

플랫폼은 Windows가 아닙니다.

13

드라이브가 동일하지 않습니다.

14

디렉터리가 비어 있지 않습니다.

15

공유 위반입니다.

16

시작 파일이 잘못되었습니다.

17

권한이 보유되지 않습니다.

21

잘못된 매개 변수입니다.

설명

이 메서드는 현재 WMI에서 구현되지 않습니다. 이 메서드를 사용하려면 자체 공급자에서 구현해야 합니다.

이 설명서는 DMTF에서 게시한 CIM 클래스 설명을 바탕으로 합니다. Microsoft에서 사소한 오류를 수정하거나, Microsoft SDK 설명서 표준을 준수하거나, 자세한 정보를 제공하기 위해 내용을 변경했을 수 있습니다.

예제

다음 Visual Basic 스크립트 코드는 TakeOwnerShipEx 메서드를 호출하여 C:\temp 폴더의 소유권을 가져옵니다.

strComputer = "." 
Set objWMIService = GetObject( _
    "winmgmts:\\" & strComputer & "\root\CIMV2") 
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx"). _
    inParameters.SpawnInstance_()

' Add the input parameters.
objInParam.Properties_.Item("Recursive") =  true

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod( _
    "Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue

요구 사항

추가 정보

CIM_Directory

CIM_Directory