[This is preliminary documentation and subject to change.]
The ConvertAccessToSecurityDescriptor function creates a self-relative security descriptor and initializes it from the specified security information.
DWORD ConvertAccessToSecurityDescriptor(
PACTRL_ACCESS pAccessList,
// pointer to the access-control information
PACTRL_AUDIT pAuditList,
// pointer to the audit-control information
LPCTSTR lpOwner, // name of the object's owner
LPCTSTR lpGroup, // name of the object's primary group
PSECURITY_DESCRIPTOR *ppSecDescriptor
// receives a pointer to the new security
// descriptor
);
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value can be one of the following error codes.
Value | Meaning |
---|---|
ERROR_NOT_ENOUGH_MEMORY | A memory allocation failed. |
ERROR_INVALID_PARAMETER | An invalid parameter was specified. |
Windows NT: Requires version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in aclapi.h.
Import Library: Use advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Access Control Overview, Access Control Functions, ACTRL_ACCESS, ACTRL_AUDIT, ConvertSecurityDescriptorToAccess, ConvertSecurityDescriptorToAccessNamed, LocalFree