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

Статья
08/25/2023

Функция GetSecurityDescriptorOwner извлекает сведения о владельце из дескриптора безопасности.

Синтаксис

BOOL GetSecurityDescriptorOwner(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pOwner,
  [out] LPBOOL               lpbOwnerDefaulted
);

Параметры

[in] pSecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR , сведения о владельце которой извлекаются функцией.

[out] pOwner

Указатель на указатель на идентификатор безопасности (SID), который идентифицирует владельца при возврате функции. Если дескриптор безопасности не содержит владельца, функция присваивает указателю, на который указывает pOwner, значение NULL и игнорирует оставшийся выходной параметр lpbOwnerDefaulted. Если дескриптор безопасности содержит владельца, функция устанавливает указатель, на который указывает pOwner , на адрес идентификатора безопасности владельца дескриптора безопасности и предоставляет допустимое значение для переменной, на которую указывает lpbOwnerDefaulted.

[out] lpbOwnerDefaulted

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

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

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

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

Требования

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