ConvertAccessToSecurityDescriptor

[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
);
 

Parameters

pAccessList
Pointer to an ACTRL_ACCESS structure that specifies information for the DACL of the security descriptor.
pAuditList
Pointer to an ACTRL_AUDIT structure that specifies information for the SACL of the security descriptor.
lpOwner
Pointer to a null-terminated string containing the name of the owner for the security descriptor. The function attempts to convert the name to an SID.
lpGroup
Pointer to a null-terminated string containing the name of the primary group for the security descriptor. The function attempts to convert the name to an SID.
ppSecDescriptor
Pointer to a variable that receives a pointer to a self-relative security descriptor. Call the LocalFree function to free the returned buffer.

Return Values

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.

QuickInfo

  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.

See Also

Access Control Overview, Access Control Functions, ACTRL_ACCESS, ACTRL_AUDIT, ConvertSecurityDescriptorToAccess, ConvertSecurityDescriptorToAccessNamed, LocalFree