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

See also

__SystemSecurity

Setting Namepace Security Descriptors