GetSecurityDescriptor method of the Win32_Service Class
The GetSecurityDescriptor method returns the security descriptor that controls access to the service. The descriptor is returned as an instance of Win32_SecurityDescriptor.
Syntax
uint32 GetSecurityDescriptor( [out] Win32_SecurityDescriptor Descriptor );
Parameters
- Descriptor [out]
-
The security descriptor associated with the service.
Return value
| Return code | Description |
|---|---|
|
Successful completion. |
|
The user does not have access to the requested information. |
|
Unknown failure. |
|
The user does not have adequate privileges to execute the method. |
|
A parameter specified in the method call is invalid. |
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
|
Minimum supported client | Windows Vista |
|---|---|
|
Minimum supported server | Windows Server 2008 |
|
MOF |
|
|
DLL |
|
|
Namespace |
\root\CIMV2 |
See also
Send comments about this topic to Microsoft
Build date: 9/7/2011
