GetSecurityDescriptor method of the __SystemSecurity class
The GetSecurityDescriptor method gets the security descriptor that controls access to the WMI namespace to which you are connected. The security descriptor is returned as an instance of__SecurityDescriptor. For more information, see Changing Access Security on Securable Objects.
Syntax
uint32 GetSecurityDescriptor(
[out] __SystemSecurity Descriptor
);
Parameters
-
Descriptor [out]
-
The security descriptor associated with the WMI namespace.
Return value
Returns one of the values listed in the following list, or a different value to indicate an error. For more information, see WMI Return Codes or WbemErrorEnum.
-
0
-
Successful completion.
-
2
-
The user does not have access to the requested information.
-
8
-
Unknown failure.
-
9
-
The user does not have adequate privileges to execute the method.
-
21
-
A parameter specified in the method call is not valid.
Remarks
The Win32_SecurityDescriptor instance represents a SECURITY_DESCRIPTOR_CONTROL data type and contains a discretionary access control list (DACL) and a system access control list (SACL). For more information, see Access Control Lists.
If the SeSecurityPrivilege is not granted or enabled when getting a security descriptor, then only the DACL is returned in the returned security descriptor. For more information, see Privilege Constants and Executing Privileged Operations.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
All WMI namespaces |