TakeOwnerShip method of the Win32_Directory class

Article
04/27/2021

The TakeOwnerShip WMI class method obtains ownership of the logical file specified in the object path. If the logical file is actually a directory, then TakeOwnerShip acts recursively, taking ownership of all of the files and subdirectories the directory contains.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method see Calling a Method.

Syntax

uint32 TakeOwnerShip();

Parameters

This method has no parameters.

Return value

Returns one of the following values.

0: The request was successful.
2: Access was denied.
8: An unspecified failure occurred.
9: The name specified was not valid.
10: The object specified already exists.
11: The file system is not NTFS.
12: The platform is not Windows.
13: The drive is not the same.
14: The directory is not empty.
15: There has been a sharing violation.
16: The start file specified was not valid.
17: A privilege required for the operation is not held.
21: A parameter specified is not valid.

Examples

The following Visual Basic Script code calls the TakeOwnerShip method to take ownership of the C:\temp folder.

strComputer = "." 

Set objWMIService = _
    GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 

' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")

' 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'", "TakeOwnerShip")

wscript.echo objOutParams.ReturnValue

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll