InitializeSecurityDescriptor

  BOOL InitializeSecurityDescriptor(SecurityDescriptor, Revision)    
  PSECURITY_DESCRIPTOR SecurityDescriptor;    
  DWORD Revision;    

The InitializeSecurityDescriptor function initializes a new security descriptor. The function initializes the security descriptor in absolute format, as opposed to self-relative format.

The InitializeSecurityDescriptor function initializes the security descriptor to have no system ACL, no discretionary ACL, no owner, no primary group, and all control flags set to false (null). The security descriptor is empty except for its revision level.

Parameters

SecurityDescriptor

Pointer to a SECURITY_DESCRIPTOR data structure that the function will initialize.

Revision

Specifies the revision level to assign to the security descriptor. This should be one (1) for this release.

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.

See Also

GetSecurityDescriptorGroup, GetSecurityDescriptorControl, GetSecurityDescriptorDacl, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, IsValidSecurityDescriptor, SetSecurityDescriptorDacl, SetSecurityDescriptorGroup, SetSecurityDescriptorOwner, SetSecurityDescriptorSacl