InitializeSecurityDescriptor
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