2.2.1.3 SECURITY_INFORMATION
The SECURITY_INFORMATION type is used to specify which portions of a security descriptor the caller would like to retrieve or set on an object.
The SECURITY_INFORMATION data type is defined in [MS-DTYP] section 2.4.7. The following declaration is an alternative definition.
This type is declared as follows:
-
typedef unsigned long SECURITY_INFORMATION;
The following table defines the bits that are relevant to the Local Security Authority (Domain Policy) Remote Protocol.
Value |
Meaning |
---|---|
OWNER_SECURITY_INFORMATION 0x00000001 |
Return the Owner portion of the security descriptor. |
GROUP_SECURITY_INFORMATION 0x00000002 |
Return the Group portion of the security descriptor. |
DACL_SECURITY_INFORMATION 0x00000004 |
Return the DACL portion of the security descriptor. |
SACL_SECURITY_INFORMATION 0x00000008 |
Return the SACL portion of the security descriptor. |
Other values SHOULD NOT be set.
The server honors the request to set or retrieve security information only if the caller has the appropriate rights to the object.
The following table lists the SECURITY_INFORMATION bits and the corresponding user rights required of the caller requesting to query information.
Security information access requested |
Rights required of caller on server |
Privileges required of caller on server |
---|---|---|
OWNER_SECURITY_INFORMATION |
READ_CONTROL |
Does not apply. |
GROUP_SECURITY_INFORMATION |
READ_CONTROL |
Does not apply. |
DACL_SECURITY_INFORMATION |
READ_CONTROL |
Does not apply. |
SACL_SECURITY_INFORMATION |
Does not apply. |
Security privilege. |
The following table lists the SECURITY_INFORMATION bits and the corresponding user rights required of the caller requesting to set information.
Security information access requested |
Rights required of caller on server |
Privileges required of caller on server |
---|---|---|
OWNER_SECURITY_INFORMATION |
WRITE_OWNER |
Take ownership privilege. Note Either the access bit or the privilege is sufficient; the caller does not need both. |
GROUP_SECURITY_INFORMATION |
WRITE_OWNER |
Take-ownership privilege. |
DACL_SECURITY_INFORMATION |
WRITE_DAC |
Does not apply. |
SACL_SECURITY_INFORMATION |
Does not apply. |
Security privilege. |