The InitializeSecurityDescriptor function initializes a new security descriptor.
BOOL InitializeSecurityDescriptor(
| PSECURITY_DESCRIPTOR pSecurityDescriptor, | // address of security descriptor |
| DWORD dwRevision | // revision level |
| ); |
Parameters
pSecurityDescriptor
Points to a SECURITY_DESCRIPTOR structure that the function initializes.
dwRevision
Specifies the revision level to assign to the security descriptor. This must be SECURITY_DESCRIPTOR_REVISION.
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.
Remarks
The InitializeSecurityDescriptor function initializes a security descriptor in absolute format, rather than self-relative format.
The InitializeSecurityDescriptor function initializes a security descriptor to have no system ACL, no discretionary ACL, no owner, no primary group, and all control flags set to FALSE (NULL). Thus, except for its revision level, it is empty.
See Also
GetSecurityDescriptorControl, GetSecurityDescriptorDacl, GetSecurityDescriptorGroup, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SetSecurityDescriptorDacl, SetSecurityDescriptorGroup, SetSecurityDescriptorOwner, SetSecurityDescriptorSacl