a5_file_get_access_control Function

Syntax

Arguments

file_or_folderCharacter

The name of a file or folder.

Returns

resultCharacter

Returns a JSON string containing permissions for a specified file/folder.

Description

Get the permissions for a file or folder.

Discussion

The a5_file_get_access_control() function returns the permissions for a file or folder on the system. The permissions are returned as a JSON string. For example:

?a5_file_get_access_control("c:\dev\A5NewsLog.txt")
= [
    {
        "group": "BUILTIN\\Administrators",
        "read": true,
        "write": true,
        "append": true,
        "delete": true
    },
    {
        "group": "NT AUTHORITY\\SYSTEM",
        "read": true,
        "write": true,
        "append": true,
        "delete": true
    },
    {
        "group": "BUILTIN\\Users",
        "read": true,
        "write": false,
        "append": false,
        "delete": false
    },
    {
        "group": "NT AUTHORITY\\Authenticated Users",
        "read": true,
        "write": true,
        "append": true,
        "delete": true
    }
]

?a5_file_get_access_control("c:\dev")
= [
    {
        "group": "BUILTIN\\Administrators",
        "read": true,
        "write": true,
        "append": true,
        "delete": true
    },
    {
        "group": "NT AUTHORITY\\SYSTEM",
        "read": true,
        "write": true,
        "append": true,
        "delete": true
    },
    {
        "group": "BUILTIN\\Users",
        "read": true,
        "write": false,
        "append": false,
        "delete": false
    },
    {
        "group": "NT AUTHORITY\\Authenticated Users",
        "read": true,
        "write": true,
        "append": true,
        "delete": true
    }
]