getSecurityDescriptorOwner 函数 (securitybaseapi.h)

GetSecurityDescriptorOwner 函数从安全描述符检索所有者信息。

语法

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

参数

[in] pSecurityDescriptor

指向函数检索其所有者信息的 SECURITY_DESCRIPTOR 结构的指针。

[out] pOwner

指向指向 安全标识符 的指针的指针 (SID) ,该 SID 在函数返回时标识所有者。 如果安全描述符不包含所有者,则该函数会将 pOwner 指向的指针设置为 NULL ,并忽略剩余的输出参数 lpbOwnerDefaulted。 如果安全描述符包含所有者,则函数会将 pOwner 指向的指针设置为安全描述符所有者 SID 的地址,并为 lpbOwnerDefaulted 指向的变量提供有效值。

[out] lpbOwnerDefaulted

指向标志的指针,该标志在函数返回时设置为SECURITY_DESCRIPTOR_CONTROL 结构中的 SE_OWNER_DEFAULTED 标志的值。 如果 存储在 pOwner 参数指向的变量中的值为 NULL,则不设置任何值。

返回值

如果函数成功,则函数返回非零值。

如果函数失败,则返回零。 要获得更多的错误信息,请调用 GetLastError。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 securitybaseapi.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

低级别访问控制

低级别访问控制函数

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorOwner