ConvertAccessToSecurityDescriptor info  Overview  Group

[This is a preview of an interface that may appear in future releases of Windows.]

The ConvertAccessToSecurityDescriptor function converts a set of access-control and audit-control structures to a self-relative security descriptor.

DWORD ConvertAccessToSecurityDescriptor(

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.

Remarks

Currently, the import library for the ConvertAccessToSecurityDescriptor function is ACCSRC.LIB. This is temporary. Eventually, the import library will be ADVAPI32.LIB. Meanwhile, any source code that links with the ACCSRC.LIB library must call the AccProvInit macro as follows:

    DWORD dwErrcode;



    AccProvInit(dwErrcode);

    if(dwErrcode != ERROR_SUCCESS)

    {

         // Consider this an error...

    }

 

See Also

ACTRL_ACCESS, ACTRL_AUDIT, ConvertSecurityDescriptorToAccess, ConvertSecurityDescriptorToAccessNamed, LocalFree 

  .