ChangeSecurityPermissionsEx method of the Win32_NTEventlogFile class

The ChangeSecurityPermissionsEx WMI class method changes the security permissions for the logical file that is specified in the Win32_NTEventlogFile.Name property (this method is an extended version of the ChangeSecurityPermissions method). If the logical file is a directory, then this method is recursive and changes the security permissions of all of the files and subdirectories that the directory contains.

Syntax

uint32 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32 Option,
  [out]          string StopFileName,
  [in, optional] string StartFileName,
  [in, optional] boolean Recursive
);

Parameters

SecurityDescriptor [in]

Expression that resolves to an instance of Win32_SecurityDescriptor. This parameter contains new security permissions for the instance of Win32_PageFile.

Option [in]

Security privilege to be modified. For example, to change the owner and discretionary access control list (DACL) security, use the following:

Option = 1 + 4

-or-

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

Value used to set the bit	Meaning
CHANGE_OWNER_SECURITY_INFORMATION 1	Change the owner of the logical file.
CHANGE_GROUP_SECURITY_INFORMATION 2	Change the group of the logical file.
CHANGE_DACL_SECURITY_INFORMATION 4	Change the DACL of the logical file.
CHANGE_SACL_SECURITY_INFORMATION 8	Change the system access control list (SACL) of the logical file.

StopFileName [out]

Name of the file or directory where the ChangeSecurityPermissionsEx 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 ChangeSecurityPermissionsEx. Typically, the StartFileName parameter is the StopFileName parameter that specifies the file or directory where an error occurs 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. For file instances, the Recursive input parameter is ignored.

Return value

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

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows Server 2003
Namespace	Root\CIMV2
MOF	Ntevt.mof
DLL	Ntevt.dll

See also

Operating System Classes

Win32_NTEventlogFile