ChangeSecurityPermissions method of the Win32_NTEventlogFile class
The ChangeSecurityPermissions WMI class method changes the security permissions for the logical file specified in the Win32_NTEventlogFile.Name property. If the logical file is a directory, then ChangeSecurityPermissions is recursive, and changes the security permissions of all of the files and subdirectories that the directory contains. ChangeSecurityPermissions returns an integer value of 0 (zero) if the permissions are changed, and a different number to indicate an error.
This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.
Syntax
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
Parameters
-
SecurityDescriptor [in]
-
Expression that resolves to an instance of Win32_SecurityDescriptor. This descriptor contains new security permissions for the instance of Win32_PageFile.
-
Option [in]
-
Actual security privilege to be modified. For example, to change the owner and discretionary access control list (DACL) security, use:
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.
Return value
Return code | Description |
---|---|
|
The request is successful. |
|
Access is denied. |
|
An unspecified failure occurred. |
|
The specified name is not valid. |
|
The specified object already exists. |
|
The file system is not an NTFS file system. |
|
The platform is not Windows. |
|
The drive is not the same. |
|
The directory is not empty. |
|
There is a sharing violation. |
|
The specified start file is not valid. |
|
A privilege required for the operation is not held. |
|
A specified parameter is not valid. |
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows Server 2003 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|