GetAppContainerAce function (securitybaseapi.h)

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