Back to product page

Attributes method


Called when wodFtpDLX retrieves file or directory attributes.

Type

none

Syntax

  • Basic
object.Attributes Owner, Size, Uid, Gid, Permissions, AccessTime, ModificationTime
The Attributes(object,Owner,Size,Uid,Gid,Permissions,AccessTime,ModificationTime) syntax has these parts:
objectAn expression evaluating to an object of type IwodFtpNotify.
OwnerRequired. A wodFtpDLXCom object.
SizeA Long value. File/directory size.
UidA Long value. User ownership for the file/directory.
GidA Long value. Group ownership for the file/directory.
PermissionsA Long value. Information about user/group rights.
AccessTimeA Date value. Determines last access time for the file/directory.
ModificationTimeA Date value. Determines last modification time for the file/directory.

Remarks

This method is called only if you implemented IwodFtpNotify interface in your application, and wodFtpDLX.Notification property has received reference to instance of your implementation.

This notification method is called as a result of GetAttributes method call. Once server returns information about requested file/directory, it will be parsed by wodFtpDLX and provided using this notification method.

Permissions are defined by the POSIX standard. For a brief description please refer to the GetAttributes page.

If you are retrieving information for files larger than 4.2GB, where remote file size cannot be presented using a long value, the Attributes64 notification method will be called instead of Attributes (the component will never call both of them). This is only done for compatibility with previous versions of our component. If you still want to use just one notification method, you should create code like this, that just wraps the new notification from the old one (code for VB):
 
Private Sub Ftp1_Attributes(ByVal Owner As wodFtpDLXCom, ByVal Size As Long, ByVal Uid As Long, ByVal Gid As Long, ByVal Permissions As Long, ByVal AccessTime As Date, ByVal ModificationTime As Date)
         Sftp1_Attributes64 Owner, Size, 0, Uid, Gid, Permissions, AccessTime, ModificationTime
End Sub
 
Private Sub Ftp1_Attributes64(ByVal Owner As wodFtpDLXCom, ByVal SizeLo As Long, ByVal SizeHi As Long, ByVal Uid As Long, ByVal Gid As Long, ByVal Permissions As Long, ByVal AccessTime As Date, ByVal ModificationTime As Date)
          ' add real code here
End Sub
 

WARNING: in protocols other than SFTP this notification will return only limited subset of available attributes. Since there is no common way to retrieve all of them, only Size and ModificationTime are provided. Other values will hold -1 value.

Platforms

Windows