AddAce功能将一个或多个ACE添加到指定的ACL。
ACE是一个访问控制条目。ACL是访问控制列表。
BOOL AddAce(
| PACL 【ACL】, | //指向访问控制列表的指针 |
| DWORD 【dwAceRevision】, | // ACL修订级别 |
| DWORD 【dwStartingAceIndex】, | // ACL中ACE位置的索引 |
| LPVOID 【pAceList】, | //指向一个或多个ACE的指针 |
| DWORD 【nAceListLength】 | // ACE的缓冲区大小 |
| ); |
参数
【ACL】
指向ACL结构。此函数将ACE添加到此ACL。
【dwAceRevision】
指定要修改的ACL的修订级别。目前，此值必须为ACL_REVISION。
【dwStartingAceIndex】
指定ACL的ACE列表中添加新ACE的位置。值为零将ACE插入列表的开头。值MAXDWORD将ACE附加到列表的末尾。
【pAceList】
指向要添加到指定ACL的一个或多个ACE的列表。列表中的ACE必须连续存储。
【nAceListLength】
指定【pAceList】参数指向的输入缓冲区的大小（以字节为单位）。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。要获取扩展错误信息，请调用GetLastError.
备注
使用AddAce功能操作ACL时，应用程序经常使用FindFirstFreeAce和GetAce功能。另外，由GetAclInformation功能检索到的ACL_SIZE_INFORMATION结构包含ACL的大小及其包含的ACE数量。
也可以看看
ACL, ACL_SIZE_INFORMATION, AddAccessAllowedAce, AddAccessDeniedAce, AddAuditAccessAce, DeleteAce, FindFirstFreeAce, GetAce, GetAclInformation
