Функция SetSecurityDescriptorOwner (securitybaseapi.h)

Статья
08/25/2023

Функция SetSecurityDescriptorOwner задает сведения о владельце дескриптора безопасности абсолютного формата. Он заменяет все сведения о владельцах, уже присутствующие в дескрипторове безопасности.

Синтаксис

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Параметры

[in, out] pSecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR , владелец которой задается этой функцией. Функция заменяет любого существующего владельца новым владельцем.

[in, optional] pOwner

Указатель на структуру SID для нового основного владельца дескриптора безопасности. На структуру SID ссылается дескриптор безопасности, а не копируется в . Если этот параметр имеет значение NULL, функция очищает сведения о владельце дескриптора безопасности. Это помечает дескриптор безопасности как не имеющий владельца.

[in] bOwnerDefaulted

Указывает, являются ли сведения владельца производными от механизма по умолчанию. Если это значение равно TRUE, это сведения по умолчанию. Функция сохраняет это значение в виде флага SE_OWNER_DEFAULTED в структуре SECURITY_DESCRIPTOR_CONTROL . Если этот параметр равен нулю, флаг SE_OWNER_DEFAULTED очищается.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	securitybaseapi.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll