ChangeSecurityPermissions method of the Win32_PageFile class
The ChangeSecurityPermissions WMI class method changes the security permissions for the logical paging file specified in the object path. 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.
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]
-
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 -
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
Returns a value of 0 (zero) if the permissions are changed, and a different number to indicate an error.
-
Success
-
0
The request is successful.
-
Access Denied
-
2
Access is denied.
-
Unspecified failure
-
8
An unspecified failure occurred.
-
Invalid object
-
9
The specified name is not valid.
-
Object already exists
-
10
The specified object already exists.
-
File system not NTFS
-
11
The file system is not an NTFS file system.
-
Platform not NT/Windows 2000
-
12
The platform is not Windows.
-
Drive not the same
-
13
The drive is not the same.
-
Directory not empty
-
14
The directory is not empty.
-
Sharing violation
-
15
There is a sharing violation.
-
Invalid start file
-
16
The specified start file is not valid.
-
Privilege not held
-
17
A privilege required for the operation is missing.
-
Invalid parameter
-
21
A specified parameter is not valid.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|