TakeOwnerShipEx method of the Win32_NTEventlogFile class

The TakeOwnerShipEx WMI class method obtains ownership of the logical file specified in the Win32_NTEventlogFile.Name property. This method is an extended version of the TakeOwnerShip method. If the logical file is actually a directory, then this method 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 TakeOwnerShipEx(
  [out]          string StopFileName,
  [in, optional] string StartFileName,
  [in, optional] boolean Recursive
);

Parameters

StopFileName [out]

Name of the file or directory where the TakeOwnerShipEx method failed. This parameter is null if the method succeeds.

StartFileName [in, optional]

Names the child file or directory to use as a starting point for TakeOwnerShipEx. The StartFileName parameter is typically the StopFileName parameter that specifies the file or directory at which an error occurred from the previous method call. If this parameter is NULL, the operation is performed on the file or directory specified in the ExecMethod call.

Recursive [in, optional]

If true, the change of ownership is applied recursively to files and directories within the directory specified by the CIM_LogicalFile instance.

Note

For file instances, the Recursive input parameter is ignored.

Return value

Requirements

See also

Operating System Classes

Win32_NTEventlogFile