Skip to content

Latest commit

 

History

History
159 lines (114 loc) · 5.71 KB

nf-aclui-isecurityinformation-getsecurity.md

File metadata and controls

159 lines (114 loc) · 5.71 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:aclui.ISecurityInformation.GetSecurity
ISecurityInformation::GetSecurity (aclui.h)
The GetSecurity method requests a security descriptor for the securable object whose security descriptor is being edited. The access control editor calls this method to retrieve the object's current or default security descriptor.
DACL_SECURITY_INFORMATION
GROUP_SECURITY_INFORMATION
GetSecurity
GetSecurity method [Security]
GetSecurity method [Security]
ISecurityInformation interface
ISecurityInformation interface [Security]
GetSecurity method
ISecurityInformation.GetSecurity
ISecurityInformation::GetSecurity
OWNER_SECURITY_INFORMATION
SACL_SECURITY_INFORMATION
_win32_isecurityinformation_getsecurity
aclui/ISecurityInformation::GetSecurity
security.isecurityinformation_getsecurity
security\isecurityinformation_getsecurity.htm
security
4c9e05fd-0b58-4d6d-b33e-067d9e8e2915
12/05/2018
DACL_SECURITY_INFORMATION, GROUP_SECURITY_INFORMATION, GetSecurity, GetSecurity method [Security], GetSecurity method [Security],ISecurityInformation interface, ISecurityInformation interface [Security],GetSecurity method, ISecurityInformation.GetSecurity, ISecurityInformation::GetSecurity, OWNER_SECURITY_INFORMATION, SACL_SECURITY_INFORMATION, _win32_isecurityinformation_getsecurity, aclui/ISecurityInformation::GetSecurity, security.isecurityinformation_getsecurity
aclui.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
ISecurityInformation::GetSecurity
aclui/ISecurityInformation::GetSecurity
c++
APIRef
kbSyntax
COM
Aclui.h
ISecurityInformation.GetSecurity

ISecurityInformation::GetSecurity

-description

The GetSecurity method requests a security descriptor for the securable object whose security descriptor is being edited. The access control editor calls this method to retrieve the object's current or default security descriptor.

-parameters

-param RequestedInformation [in]

A set of SECURITY_INFORMATION bit flags that indicate the parts of the security descriptor being requested. This parameter can be a combination of the following values.

Value Meaning
OWNER_SECURITY_INFORMATION
The security descriptor must include the SID of the object's owner.
GROUP_SECURITY_INFORMATION
The security descriptor must include the SID of the object's primary group.
DACL_SECURITY_INFORMATION
The security descriptor must include the object's DACL.
SACL_SECURITY_INFORMATION
The security descriptor must include the object's SACL.

-param ppSecurityDescriptor [out]

A pointer to a variable that your implementation must set to a pointer to the object's security descriptor. The security descriptor must include the components requested by the RequestedInformation parameter.

The system calls the LocalFree function to free the returned pointer.

-param fDefault [in]

If this parameter is TRUE, ppSecurityDescriptor should return an application-defined default security descriptor for the object. The access control editor uses this default security descriptor to reinitialize the property page.

The access control editor sets this parameter to TRUE only if the user clicks the Default button. The Default button is displayed only if you set the SI_RESET flag in the ISecurityInformation::GetObjectInformation method. If no default security descriptor is available, do not set the SI_RESET flag.

If this flag is FALSE, ppSecurityDescriptor should return the object's current security descriptor.

-returns

Returns S_OK if successful.

Returns a nonzero error code if an error occurs. Returns E_ACCESSDENIED if the user does not have permission to read the requested security information.

-see-also

Access Control Editor

Access Control Editor Functions

ISecurityInformation

ISecurityInformation::GetObjectInformation

LocalFree

SECURITY_INFORMATION