Windows Dev Center

EN
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

ChangeSecurityPermissionsEx method of the Win32_CodecFile class

The ChangeSecurityPermissionsEx WMI class method changes the security permissions for the codec file specified in the object path (this method is an extended version of the ChangeSecurityPermissions method). If the logical file is a directory, then this method is recursive, and changes the security permissions of all 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 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32 Option,
  [out]          string StopFileName,
  [in, optional] string StartFileName,
  [in, optional] boolean Recursive
);

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]

Actual security privilege to be modified. For example, to change the owner and discretionary access control list (DACL) security, use the following:

Option = 1 + 4

-or-

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

Value used to set the bitMeaning
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.

 

StopFileName [out]

Name of the file or directory where the ChangeSecurityPermissionsEx method failed. This parameter is null when the method succeeds.

StartFileName [in, optional]

Names the child file or directory to use as a starting point for ChangeSecurityPermissionsEx. Typically, the StartFileName parameter is the StopFileName parameter that specifies the file or directory where an error occurred from the previous method call. If this parameter is null, the operation is performed on the file or directory specified in the ExecMethod call.

Recursive [in, optional]

If true, the changes of ownership are applied recursively to files and directories in the directory that the CIM_LogicalFile instance specifies. For file instances, the Recursive input parameter is ignored.

Return value

Return code/valueDescription
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 NT or Windows 2000.

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 parameter specified is not valid.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Operating System Classes
Win32_CodecFile

 

 

Anzeigen:
© 2015 Microsoft