FileGetAttr - method of object Pm
Description:
Returns the file attributes.
Syntax:
Long FileGetAttr(String sFile, Long nMask)
Calling:
val = Pm.FileGetAttr(sFile, nMask)Parameters:
| sFile | (String) The file whose attributes have to be obtained. If a full path is not entered, then it is completed relative to the application file folder. It is recommended to use the PROMOTIC path syntax - see PROMOTIC path to files and folders. |
|---|
| nMask | (Long) Specifies which attributes have to be returned. For example, 1+2 returns the attributes "archive" and "read only". 1 - The attribute "archive" is returned. 2 - The attribute "read only" is returned. 4 - The attribute "hidden" is returned. |
|---|
Return Values:
Returns the settings of required attributes according to the mask set in the nMask parameter. If file doesn't exist or is not accessible, then -1 is returned.
Example:
It gets the attributes "
archive" and "
read only", see the parameter
nMask = 1+2. The returned value is the numeric value depending on setting the bits.
If the file has set only the attribute "archive", then in nAttr there is the value 1.
If the file has set only the attribute "read only", then in nAttr there is the value 2.
If the file has set both attributes, then in nAttr there is the value 3.
JavaScriptVBScriptSelect and copy to clipboard
var sFile = "#app:file.txt";
var nAttr = Pm.FileGetAttr(sFile, 1+2);
if (nAttr >= 0)
//If the attributes were get OK
Dim sFile, nAttr
sFile = "#app:file.txt"
nAttr = Pm.FileGetAttr(sFile, 1+2)
If nAttr >= 0 Then
'If the attributes were get OK
End If