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(

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.

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