This topic has not yet been rated - Rate this topic

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

mof


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

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
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 2000 or Windows NT.
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 missing.
21	A specified parameter is not valid.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Namespace	\root\CIMV2
MOF	Cimwin32.mof
DLL	Cimwin32.dll

Community Additions

ADD