|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| advapi32.lib
| Header File
| winbase.h
| Unicode
| No
| Platform Notes
| None
|
|
|
GetSecurityDescriptorDacl
The GetSecurityDescriptorDacl function retrieves a pointer to the discretionary access-control list (ACL)
in a specified security descriptor.
BOOL GetSecurityDescriptorDacl(
PSECURITY_DESCRIPTOR pSecurityDescriptor,
| // address of security descriptor
| LPBOOL lpbDaclPresent,
| // address of flag for presence of disc. ACL
| PACL *pDacl,
| // address of pointer to ACL
| LPBOOL lpbDaclDefaulted
| // address of flag for default disc. ACL
| );
|
|
Parameters
pSecurityDescriptor
Points to the SECURITY_DESCRIPTOR structure containing the discretionary ACL. The function retrieves a pointer
to it.
lpbDaclPresent
Points to a flag the function sets to indicate the presence of a discretionary
ACL in the specified security descriptor. If this parameter is TRUE, the
security descriptor contains a discretionary ACL, and the remaining output
parameters in this function receive valid values. If this parameter is FALSE, the
security descriptor does not contain a discretionary ACL, and the remaining output
parameters do not receive valid values.
pDacl
Points to a pointer to an ACL structure. If a discretionary ACL exists, the function sets the pointer
pointed to by pDacl to the address of the security descriptor's discretionary ACL. If a
discretionary ACL does not exist, no value is stored.
If the function stores a NULL value in the pointer pointed to by pDacl, the security descriptor has a NULL discretionary ACL. A NULL discretionary
ACL implicitly allows all access to an object.
lpbDaclDefaulted
Points to a flag set to the value of the SE_DACL_DEFAULTED flag in the SECURITY_DESCRIPTOR_CONTROL structure if a discretionary ACL exists for the security descriptor. If this
flag is TRUE, the discretionary ACL was retrieved by a default mechanism; if
FALSE, the discretionary ACL was explicitly specified by a user.
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
ACL, GetSecurityDescriptorControl, GetSecurityDescriptorGroup, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, InitializeSecurityDescriptor, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SECURITY_DESCRIPTOR_CONTROL, SetSecurityDescriptorDacl
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
