GetSecurityDescriptorOwner

	BOOL GetSecurityDescriptorOwner(SecurityDescriptor, Owner, lpfOwnerDefaulted)
	PSECURITY_DESCRIPTOR SecurityDescriptor;
	PSID *Owner;
	LPBOOL lpfOwnerDefaulted;

The GetSecurityDescriptorOwner function retrieves a security descriptor's owner.

Parameters

SecurityDescriptor

Pointer to a SECURITY_DESCRIPTOR data structure whose owner the function will retrieve.

Owner

Pointer to a pointer to an SID data structure. If the security descriptor does not currently contain an owner, the function will set the pointer pointed to by Owner to NULL, and will ignore the remaining output parameter, lpfOwnerDefaulted. If the security descriptor does contain an owner, the function will set the pointer pointed to by Owner to the address of the security descriptor's owner SID, and will provide a valid value for the variable pointed to by lpfOwnerDefaulted.

lpfOwnerDefaulted

Pointer to a Boolean variable. If the value stored into the variable pointed to by Owner is not NULL, the function sets the variable pointed to by lpfOwnerDefaulted to the value of the security descriptor's OwnerDefaulted control flag. If the value stored into the variable pointed to by Owner is NULL, no value is set.

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.