Edit

ISecurityObjectTypeInfo::GetInheritSource method (aclui.h)

  • Article

The GetInheritSource method provides a means of determining the source of inherited access control entries (ACEs) in discretionary access control lists (DACLs) and system access control lists (SACLs).

Syntax

HRESULT GetInheritSource(
  [in]  SECURITY_INFORMATION si,
  [in]  PACL                 pACL,
  [out] PINHERITED_FROM      *ppInheritArray
);

Parameters

[in] si

A SECURITY_INFORMATION structure that represents the security information of the object.

[in] pACL

A pointer to an ACL structure that represents the access control list (ACL) of the object.

[out] ppInheritArray

A pointer to a pointer to an INHERITED_FROM structure that receives an array of INHERITED_FROM structures. The length of this array is the same as the number of ACEs in the ACL referenced by pACL. Each INHERITED_FROM entry in ppInheritArray provides inheritance information for the corresponding ACE entry in pACL.

Return value

If the function is successful, the return value is S_OK.

If the function fails, the return value is an HRESULT that indicates the error. For a list of common error codes, see Common HRESULT Values.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header aclui.h