ssCore.FileSys.getAttrs

Returns the attributes of the specified file or directory.


Availability:

First available in version 3.0 build 2039.


Input Parameters:

path - A fully qualified path to a file or directory. This parameter supports monikers.


Output Parameters:

result - The attributes of the file specified by the path argument.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.FileSys.getAttrs( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.FileSys.getAttrs( paramsObject );


Notes:

If successful, the file atributes are returned in a string with one letter representing each of the possible atributes. A file or directory with all possible attributes set would return "ACDHRS".

Not all of the specified attributes will be returned with every call so don't depend on the position of the attribute in the returned string. An empty string may be returned for a file with no special attributes set.

                

Examples:

var return_obj = ssCore.FileSys.getAttrs({path:"startdir://file.txt"});

ssDebug.trace(return_obj.result);