Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|