ChangeSecurityPermissions method of the Win32_CodecFile class
The ChangeSecurityPermissions WMI class method changes the security permissions for the logical codec 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 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_CodecFile.
-
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 (0x1))
-
Change the owner of the logical file.
-
CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2))
-
Change the group of the logical file.
-
CHANGE_DACL_SECURITY_INFORMATION (4 (0x4))
-
Change the discretionary access control list (DACL) of the logical file.
-
CHANGE_SACL_SECURITY_INFORMATION (8 (0x8))
-
Change the system access control list (SACL) of the logical file.
Return value
Returns an 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 not held.
-
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 |
|