GetAce 函式 (securitybaseapi.h)

GetAce函式會在存取控制清單中取得存取控制專案指標, (ACE) (ACL) 。

語法

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

參數

[in] pAcl

ACL 的指標,其中包含要擷取的 ACE。

[in] dwAceIndex

要擷取之 ACE 的索引。 值為零會對應至 ACL 中的第一個 ACE、一個到第二個 ACE 的值,依此類推。

[out] pAce

函式設定為 ACE 位址的指標指標。

傳回值

如果函式成功,函式會傳回非零。

如果函式失敗,則會傳回零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 securitybaseapi.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

低階存取控制

低階存取控制函式