Функция 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

См. также раздел

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Низкоуровневые контроль доступа

Низкоуровневые функции контроль доступа

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl