Security_SetFilePermissions
Description
Section titled “Description”Sets access right for a trustee on a file.
sRight can be one of the following values:
- F: Full Control
- C: Change
- R: Read
- X: Execute
- E: Read Execute
- W: Write
- D: Delete
Syntax
Section titled “Syntax”Security_SetFilePermissions(sFile, sTrustee, sRight) As Boolean
Parameters
Section titled “Parameters”sFile (String)
Section titled “sFile (String)”Full path of the file
sTrustee (String)
Section titled “sTrustee (String)”A trustee is a user or group. The trustee can be a name in the format Domain\User or a well-known SID (security identifier). Some built-in group names, such as Power Users, are localized, so use the SID for those.
sRight (String)
Section titled “sRight (String)”Access right to set. To set more than one right, combine the letters in one string, for example "RW".
Return value
Section titled “Return value”The function returns False if SubInACL.exe can’t be found, or if SubInACL reports an error. See Security functions for where the library looks for SubInACL.exe.
Example
Section titled “Example”If bStatus Then bStatus = Security_SetFilePermissions(gsProgramFiles & "\CapaInstaller\CapaInstaller.bat", "S-1-5-4", "F")Related functions
Section titled “Related functions”Security functions Security_DenyFileAccess Security_RevokeFilePermissions Constants Package Property Variables