UpdateResourceACLRequest: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Remove obsolete Requirements section)
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{server function}}
{{server function}}
{{New feature/item|3.0120|1.2||
 
Only available in MTA:SA 1.2 and onwards.
}}
This function changes the access for one ACL request of the given resource.
This function changes the access for one ACL request of the given resource.
 
{{Note|This function is protected by default and must be explicitly allowed in the server ACL.}}
Note: This function is protected by default and must be explicitly allowed in the server ACL.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool updateResourceACLRequest ( resource theResource, string rightName, bool access[, string byWho] )  
bool updateResourceACLRequest ( resource theResource, string rightName, bool access [, string byWho = "" ] )  
</syntaxhighlight>  
</syntaxhighlight>  


Line 34: Line 31:
end
end
</syntaxhighlight>
</syntaxhighlight>
==Requirements==
 
{{Requirements|1.2|n/a|}}
==See Also==
==See Also==
{{Resource_functions}}
{{Resource_functions|server}}

Latest revision as of 15:40, 7 November 2024

This function changes the access for one ACL request of the given resource.

[[{{{image}}}|link=|]] Note: This function is protected by default and must be explicitly allowed in the server ACL.

Syntax

bool updateResourceACLRequest ( resource theResource, string rightName, bool access [, string byWho = "" ] ) 

Required Arguments

  • theResource: the resource to set the ACL request for.
  • rightName: a string with the name of the right to set the access for. This has to match an existing ACL request.
  • access: a boolean value setting the access. True is for allow, and false for deny.

Optional Arguments

  • byWho: a string value to identity who is changing the setting.

Returns

Returns true if the setting was changed, or false if no change was required or there was a problem with the arguments.

Example

This function will allow all ACL requests from 'theResource'

function allowAllACLRequests(theResource)
  local requests = getResourceACLRequests (theResource)
  for _,request in ipairs(requests) do
    updateResourceACLRequest ( theResource, request.name, true ) 
  end
end

See Also