Функция InitializeSecurityDescriptor (securitybaseapi.h)
Функция InitializeSecurityDescriptor инициализирует новый дескриптор безопасности.
Синтаксис
BOOL InitializeSecurityDescriptor(
[out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] DWORD dwRevision
);
Параметры
[out] pSecurityDescriptor
Указатель на структуру SECURITY_DESCRIPTOR , инициализируемую функцией.
[in] dwRevision
Уровень редакции, назначаемой дескриптору безопасности. Этот параметр должен быть SECURITY_DESCRIPTOR_REVISION.
Возвращаемое значение
Если функция выполняется успешно, функция возвращает ненулевое значение.
Если функция завершается сбоем, она возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Функция InitializeSecurityDescriptor инициализирует дескриптор безопасности в абсолютном формате, а не в автономном формате.
Функция InitializeSecurityDescriptor инициализирует дескриптор безопасности так, чтобы не было системного списка управления доступом (SACL), списка управления доступом на уровне пользователей (DACL), владельца, основной группы и для всех флагов управления задано значение FALSE (NULL). Таким образом, за исключением уровня редакции, он пуст.
Примеры
Пример использования этой функции см. в разделе Создание дескриптора безопасности для нового объекта.
Требования
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | securitybaseapi.h (включая Windows.h) |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |
См. также раздел
Низкоуровневые контроль доступа