SetSecurityDescriptorOwner
The SetSecurityDescriptorOwner
function sets the owner information of an absolute-format security descriptor.
It replaces any owner information already present in the security descriptor.
BOOL SetSecurityDescriptorOwner(
|
PSECURITY_DESCRIPTOR pSecurityDescriptor, |
// address of security
descriptor |
|
PSID pOwner, |
// address of SID
for owner |
|
BOOL bOwnerDefaulted |
// flag for default |
|
); |
|
Parameters
pSecurityDescriptor
Points to the
SECURITY_DESCRIPTOR
structure whose owner is set by this function. The function replaces any
existing owner with the new owner.
pOwner
Points to a SID structure the function sets
as the security descriptor s new primary owner. The SID structure is
referenced by, not copied into, the security descriptor. If this parameter is
NULL, the function clears the security descriptor s owner information. This
marks the security descriptor as having no owner.
bOwnerDefaulted
Specifies a
flag indicating whether the owner information is derived from a default
mechanism. If this flag is TRUE, it is default information. The function stores
this value as the SE_OWNER_DEFAULTED flag in the SECURITY_DESCRIPTOR_CONTROL structure. If this
parameter is zero, the SE_OWNER_DEFAULTED flag is cleared.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
See Also