SetSecurityDescriptorOwner函数设置绝对格式安全描述符的所有者信息。它替换已经存在于安全描述符中的所有者信息。
BOOL SetSecurityDescriptorOwner(
PSECURITY_DESCRIPTOR 【pSecurityDescriptor】, | //安全描述符的地址 |
PSID 【pOwner】, | //所有者的SID地址 |
BOOL 【bOwnerDefaulted】 | //标志为默认值 |
); |
参数
【pSecurityDescriptor】
指向由此函数设置其所有者的SECURITY_DESCRIPTOR结构。该函数将替换任何现有的拥有者与新的所有者。
【pOwner】
指向SID结构的功能集作为安全描述符的新的主所有者。SID结构由安全描述符引用,不会复制到安全描述符中。如果此参数为NULL,则该函数将清除安全描述符的所有者信息。这标志着安全描述符没有所有者。
【bOwnerDefaulted】
指定一个标志,指示所有者信息是否从默认机制派生。如果此标志为TRUE,则为默认信息。该函数将此值存储在SECURITY_DESCRIPTOR_CONTROL结构中的SE_OWNER_DEFAULTED标志。如果此参数为零,则SE_OWNER_DEFAULTED标志将被清除。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
也可以看看
GetSecurityDescriptorOwner, InitializeSecurityDescriptor, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SECURITY_DESCRIPTOR_CONTROL, SetSecurityDescriptorDacl, SetSecurityDescriptorGroup, SetSecurityDescriptorSacl, SID