Edit

Share via

GetAppContainerAce function (securitybaseapi.h)

  • Article

Retrieves a value that indicates whether a package or capability SID is present.

Syntax

BOOL GetAppContainerAce(
  [in]            PACL  Acl,
  [in]            DWORD StartingAceIndex,
  [out]           PVOID *AppContainerAce,
  [out, optional] DWORD *AppContainerAceIndex
);

Parameters

[in] Acl

A pointer to an ACL structure.

[in] StartingAceIndex

Specifies the position in the ACL's list of ACEs at which to add new ACEs. A value of zero inserts the ACEs at the beginning of the list. A value of MAXDWORD appends the ACEs to the end of the list.

[out] AppContainerAce

Pointer to an AppContainerAce object.

[out, optional] AppContainerAceIndex

The position in the ACL's list of ACEs.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError. GetLastError may return one of the error codes defined in WinError.h.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header securitybaseapi.h (include Windows.h)
Library Advapi32.lib
DLL Advapi32.dll