Функция FindFirstFreeAce (securitybaseapi.h)
Функция FindFirstFreeAce извлекает указатель на первый свободный байт в списке управления доступом (ACL).
Синтаксис
BOOL FindFirstFreeAce(
[in] PACL pAcl,
[out] LPVOID *pAce
);
Параметры
[in] pAcl
Указатель на список ACL.
[out] pAce
Адрес указателя на первую свободную позицию в ACL, созданной при возврате функции. Если список ACL недопустим, этот параметр имеет значение NULL. Если список ACL заполнен, этот параметр указывает на байт, непосредственно следующий за ACL.
Возвращаемое значение
Если функция выполняется успешно, функция возвращает ненулевое значение.
Если функция завершается сбоем, она возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | securitybaseapi.h (включая Windows.h) |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |