SetSecurityDescriptor method of the Win32_LogicalShareSecuritySetting class
The SetSecurityDescriptor WMI class method sets a security descriptor to a specified structure.
This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.
Syntax
uint32 SetSecurityDescriptor(
[in] Win32_SecurityDescriptor Descriptor
);
Parameters
-
Descriptor [in]
-
An expression that resolves to an instance of a Win32_SecurityDescriptor.
Return value
The SetSecurityDescriptor method can return the error codes listed in the following list. For more information, see WMI Return Codes.
-
Success
-
0
Successful completion.
-
Access denied
-
2
The user does not have access to the requested information.
-
Unknown failure
-
8
Unknown failure.
-
Privilege missing
-
9
The user does not have adequate privileges.
-
Invalid parameter
-
21
The specified parameter is not valid.
-
Other
-
22 4294967295
Remarks
For a VBScript code example of how to get the security descriptor, change it, and write it back, see SetSecurityDescriptor Method in Class Win32_LogicalFileSecuritySetting.
The SeSecurityPrivilege privilege is required to execute this method. For more information, see Executing Privileged Operations.
When a new security access control list (SACL) is not specified in a call to a SetSecurityDescriptor method, then the security descriptor SACL on the target securable object is set to NULL so that the previous SACL setting does not persist.
Requirements
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMv2 |
| MOF |
|
| DLL |
|